Update stylelint to V16.26.1

.circleci/config.yml

@@ -1,8 +1,8 @@
 version: 2.1
 
 orbs:
-  codacy: codacy/base@12.2.0
-  codacy_plugins_test: codacy/plugins-test@2.0.11
+  codacy: codacy/base@13.0.5
+  codacy_plugins_test: codacy/plugins-test@2.1.2
 
 workflows:
   compile_test_deploy:

Dockerfile

@@ -1,4 +1,4 @@
-FROM node:lts-alpine3.22
+FROM node:lts-alpine3.23
 
 WORKDIR /workdir
 

docs/description/alpha-value-notation.md

@@ -9,7 +9,9 @@ Specify percentage or number notation for alpha-values.
  *                         This notation */
 ```
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the alpha value and its expected notation.
 
 ## Options
 

docs/description/annotation-no-unknown.md

@@ -11,6 +11,8 @@ a { color: green !imprtant; }
 
 This rule considers annotations defined in the CSS Specifications, up to and including Editor's Drafts, to be known.
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the unknown annotation.
+
 ## Options
 
 ### `true`

docs/description/at-rule-allowed-list.md

@@ -11,19 +11,21 @@ Specify a list of allowed at-rules.
 
 This rule ignores the `@charset` rule.
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the disallowed at-rule.
+
 ## Options
 
 ### `Array<string>`
 
 ```json
-["array", "of", "unprefixed", "at-rules"]
+["array", "of", "at-rules", "/regex/"]
 ```
 
 Given:
 
 ```json
 {
-  "at-rule-allowed-list": ["extend", "keyframes"]
+  "at-rule-allowed-list": ["extend", "/^(-webkit-|-moz-)?keyframes$/i"]
 }
 ```
 

docs/description/at-rule-descriptor-no-unknown.md

@@ -13,13 +13,14 @@ Disallow unknown descriptors for at-rules.
 
 This rule considers descriptors defined in the CSS Specifications, up to and including Editor's Drafts, to be known.
 
-You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what descriptors are known for an at-rule.
+You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what descriptors are known for an at-rule, and use the [`languageOptions`](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#languageoptions) configuration property to extend it.
 
-This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
+> [!WARNING]
+> This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
 
-This rule checks descriptors within at-rules. To check properties, you can use the [`property-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/property-no-unknown/README.md) rule.
+This rule checks descriptors within at-rules. To check properties, you can use the [`property-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/property-no-unknown/README.md) rule.
 
-For customizing syntax, see the [`languageOptions`](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/configure.md#languageoptions) section.
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the at-rule and the unknown descriptor.
 
 Prior art:
 

docs/description/at-rule-descriptor-value-no-unknown.md

@@ -13,23 +13,23 @@ Disallow unknown values for descriptors within at-rules.
 
 This rule considers descriptors and values defined in the CSS Specifications, up to and including Editor's Drafts, to be known.
 
-You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what values are valid for a descriptor of an at-rule.
+You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what values are known for a descriptor of an at-rule, and use the [`languageOptions`](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#languageoptions) configuration property to extend it.
 
-This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
+This rule checks descriptor values within at-rules. You can use [`declaration-property-value-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/declaration-property-value-no-unknown/README.md) to disallow unknown values for properties within declarations, and [`at-rule-descriptor-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/at-rule-descriptor-no-unknown/README.md) to disallow unknown descriptors for at-rules.
 
-This rule checks descriptor values within at-rules. You can use [`declaration-property-value-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/declaration-property-value-no-unknown/README.md) to disallow unknown values for properties within declarations, and [`at-rule-descriptor-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/at-rule-descriptor-no-unknown/README.md) to disallow unknown descriptors for at-rules.
+> [!WARNING]
+> This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
 
-This rule overlaps with:
+> [!NOTE]
+> When using this rule, we recommend turning off these overlapping rules or configuring them to ignore the overlaps:
+>
+> - [`color-no-invalid-hex`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/color-no-invalid-hex/README.md)
+> - [`function-linear-gradient-no-nonstandard-direction`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/function-linear-gradient-no-nonstandard-direction/README.md)
+> - [`function-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/function-no-unknown/README.md)
+> - [`string-no-newline`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/string-no-newline/README.md)
+> - [`unit-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/unit-no-unknown/README.md)
 
-- [`color-no-invalid-hex`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/color-no-invalid-hex/README.md)
-- [`function-linear-gradient-no-nonstandard-direction`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/function-linear-gradient-no-nonstandard-direction/README.md)
-- [`function-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/function-no-unknown/README.md)
-- [`string-no-newline`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/string-no-newline/README.md)
-- [`unit-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/unit-no-unknown/README.md)
-
-You can either turn off the rules or configure them to ignore the overlaps.
-
-For customizing syntax, see the [`languageOptions`](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/configure.md#languageoptions) section.
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the descriptor and the unknown value.
 
 Prior art:
 

docs/description/at-rule-disallowed-list.md

@@ -11,19 +11,21 @@ Specify a list of disallowed at-rules.
 
 This rule ignores the `@charset` rule.
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the disallowed at-rule.
+
 ## Options
 
 ### `Array<string>`
 
 ```json
-["array", "of", "unprefixed", "at-rules"]
+["array", "of", "at-rules", "/regex/"]
 ```
 
 Given:
 
 ```json
 {
-  "at-rule-disallowed-list": ["extend", "keyframes"]
+  "at-rule-disallowed-list": ["extend", "/^(-webkit-|-moz-)?keyframes$/i"]
 }
 ```
 

docs/description/at-rule-empty-line-before.md

@@ -17,7 +17,9 @@ This rule ignores:
 - the `@charset` rule
 - `@import` in Less
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+This rule doesn't have any [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message).
 
 ## Options
 

docs/description/at-rule-no-deprecated.md

@@ -17,7 +17,9 @@ This rule flags at-rules that were removed or deprecated after being in the CSS
 - polyfilled with some adoption before any browser actually shipped
 - had an MDN page at one point in time
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix some of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix some of the problems reported by this rule.
+
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the deprecated at-rule.
 
 Prior art:
 

docs/description/at-rule-no-unknown.md

@@ -11,7 +11,9 @@ Disallow unknown at-rules.
 
 This rule considers at-rules defined in the CSS Specifications, up to and including Editor's Drafts, to be known.
 
-For customizing syntax, see the [`languageOptions`](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/configure.md#languageoptions) section.
+For customizing syntax, see the [`languageOptions`](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#languageoptions) section.
+
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the unknown at-rule.
 
 ## Options
 

docs/description/at-rule-no-vendor-prefix.md

@@ -11,7 +11,9 @@ Disallow vendor prefixes for at-rules.
 
 This rule ignores non-standard vendor-prefixed at-rules that aren't handled by [Autoprefixer](https://github.com/postcss/autoprefixer).
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule. However, it will not remove duplicate at-rules produced when the prefixes are removed. You can use [Autoprefixer](https://github.com/postcss/autoprefixer) itself, with the [`add` option off and the `remove` option on](https://github.com/postcss/autoprefixer#options), in these situations.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule. However, it will not remove duplicate at-rules produced when the prefixes are removed. You can use [Autoprefixer](https://github.com/postcss/autoprefixer) itself, with the [`add` option off and the `remove` option on](https://github.com/postcss/autoprefixer#options), in these situations.
+
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the vendor-prefixed at-rule.
 
 ## Options
 
@@ -46,3 +48,34 @@ The following patterns are _not_ considered problems:
 ```css
 @viewport { orientation: landscape; }
 ```
+
+## Optional secondary options
+
+### `ignoreAtRules`
+
+```json
+{ "ignoreAtRules": ["array", "of", "at", "rules", "/regex/"] }
+```
+
+Given:
+
+```json
+{
+  "at-rule-no-vendor-prefix": [
+    true,
+    { "ignoreAtRules": ["-webkit-keyframes", "/-viewport/i"] }
+  ]
+}
+```
+
+The following patterns are _not_ considered problems:
+
+<!-- prettier-ignore -->
+```css
+@-webkit-keyframes {}
+```
+
+<!-- prettier-ignore -->
+```css
+@-ms-viewport {}
+```

docs/description/at-rule-prelude-no-invalid.md

@@ -11,19 +11,19 @@ Disallow invalid preludes for at-rules.
 
 This rule considers preludes for at-rules defined within the CSS specifications, up to and including Editor's Drafts, to be valid.
 
-You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what preludes are valid for an at-rule.
+You can filter the [CSSTree Syntax Reference](https://csstree.github.io/docs/syntax/) to find out what preludes are valid for an at-rule, and use the [`languageOptions`](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#languageoptions) configuration property to extend it.
 
-This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
+> [!WARNING]
+> This rule is only appropriate for CSS. You should not turn it on for CSS-like languages, such as SCSS or Less.
 
-This rule overlaps with:
+> [!NOTE]
+> When using this rule, we recommend turning off these overlapping rules or configuring them to ignore the overlaps:
+>
+> - [`media-query-no-invalid`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/media-query-no-invalid/README.md)
+> - [`string-no-newline`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/string-no-newline/README.md)
+> - [`unit-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/unit-no-unknown/README.md)
 
-- [`media-query-no-invalid`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/media-query-no-invalid/README.md)
-- [`string-no-newline`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/string-no-newline/README.md)
-- [`unit-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/unit-no-unknown/README.md)
-
-You can either turn off the rules or configure them to ignore the overlaps.
-
-For customizing syntax, see the [`languageOptions`](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/configure.md#languageoptions) section.
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the at-rule and the invalid prelude.
 
 Prior art:
 

docs/description/at-rule-property-required-list.md

@@ -9,6 +9,8 @@ Specify a list of required properties (or descriptors) for an at-rule.
  *  At-rule and required descriptor names */
 ```
 
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the at-rule and the required property.
+
 ## Options
 
 ### `Array<string>`

docs/description/block-no-empty.md

@@ -9,6 +9,8 @@ Disallow empty blocks.
  * Blocks like this */
 ```
 
+This rule doesn't have any [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message).
+
 ## Options
 
 ### `true`

docs/description/block-no-redundant-nested-style-rules.md

@@ -9,6 +9,8 @@ a { & { color: red; } }
  * This nested style rule */
 ```
 
+This rule doesn't have any [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message).
+
 ## Options
 
 ### `true`

docs/description/color-function-alias-notation.md

@@ -11,7 +11,9 @@ Specify alias notation for color-functions.
 
 Color functions `rgb()` and `hsl()` have aliases `rgba()` and `hsla()`. Those are exactly equivalent, and [it's preferable](https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/rgb) to use the first variant without `a`.
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the color value and its expected notation.
 
 ## Options
 

docs/description/color-function-notation.md

@@ -13,7 +13,9 @@ Modern color-functions use a comma-free syntax because functions in CSS are used
 
 For legacy reasons, `rgb()` and `hsl()` also supports an alternate syntax that separates all of its arguments with commas. Also for legacy reasons, the `rgba()` and `hsla()` functions exist using the same comma-based syntax.
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix some of the problems reported by this rule when the primary option is `"modern"`.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix some of the problems reported by this rule when the primary option is `"modern"`.
+
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the configured notation.
 
 ## Options
 

docs/description/color-hex-alpha.md

@@ -9,6 +9,8 @@ a { color: #fffa }
  * This alpha channel */
 ```
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the hex color.
+
 ## Options
 
 ### `"always"`

docs/description/color-hex-length.md

@@ -9,7 +9,9 @@ a { color: #fff }
  * This hex color */
 ```
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+This rule supports 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the hex color and its expected notation.
 
 ## Options
 

docs/description/color-named.md

@@ -11,6 +11,8 @@ a { color: black }
 
 This rule ignores `$sass` and `@less` variable syntaxes.
 
+This rule supports up to 2 [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the disallowed named color, or a color and its named equivalent.
+
 ## Options
 
 ### `"always-where-possible"`

docs/description/color-no-hex.md

@@ -9,6 +9,8 @@ a { color: #333 }
  * This hex color */
 ```
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the disallowed hex color.
+
 ## Options
 
 ### `true`

docs/description/color-no-invalid-hex.md

@@ -11,12 +11,13 @@ a { color: #y3 }
 
 Longhand hex colors can be either 6 or 8 (with alpha channel) hexadecimal characters. And their shorthand variants are 3 and 4 characters respectively.
 
-This rule overlaps with:
+> [!NOTE]
+> We recommend only using this rule for CSS-like languages, such as SCSS and Less. For CSS, we recommend using these more capable and overlapping rules instead:
+>
+> - [`at-rule-descriptor-value-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/at-rule-descriptor-value-no-unknown/README.md)
+> - [`declaration-property-value-no-unknown`](https://github.com/stylelint/stylelint/17.13.0/lib/rules/declaration-property-value-no-unknown/README.md)
 
-- [`at-rule-descriptor-value-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/at-rule-descriptor-value-no-unknown/README.md)
-- [`declaration-property-value-no-unknown`](https://github.com/stylelint/stylelint/16.23.0/lib/rules/declaration-property-value-no-unknown/README.md)
-
-We recommend using these rules for CSS and this rule for CSS-like languages, such as SCSS and Less.
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the invalid hex color.
 
 ## Options
 

docs/description/comment-empty-line-before.md

@@ -18,7 +18,9 @@ This rule ignores:
 - single-line comments with `//` (when you're using a custom syntax that supports them)
 - comments within selector and value lists
 
-The [`fix` option](https://github.com/stylelint/stylelint/16.23.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+The [`fix` option](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/options.md#fix) can automatically fix all of the problems reported by this rule.
+
+This rule doesn't have any [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message).
 
 ## Options
 

docs/description/comment-no-empty.md

@@ -14,6 +14,8 @@ This rule ignores SCSS-like comments.
 > [!WARNING]
 > Comments within _selector and value lists_ are currently ignored.
 
+This rule doesn't have any [message arguments](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message).
+
 ## Options
 
 ### `true`

docs/description/comment-pattern.md

@@ -9,6 +9,8 @@ Specify a pattern for comments.
  * The pattern of this */
 ```
 
+This rule supports 1 [message argument](https://github.com/stylelint/stylelint/17.13.0/docs/user-guide/configure.md#message): the configured pattern.
+
 ## Options
 
 ### `string`