eslint-plugin-stylelint-2 1.0.9

package/docs/rules/prefer-stylelint-report-descriptionless-disables.md

@@ -0,0 +1,85 @@
+# prefer-stylelint-report-descriptionless-disables
+
+Require enabling Stylelint's `reportDescriptionlessDisables` config option in authored Stylelint config files.
+
+## Targeted pattern scope
+
+This rule targets Stylelint config modules such as `stylelint.config.ts`, `stylelint.config.mjs`, and `.stylelintrc.js`.
+
+It focuses on top-level exported config objects, including configs wrapped in `defineConfig(...)`.
+
+## What this rule reports
+
+This rule reports Stylelint config objects when `reportDescriptionlessDisables` is:
+
+- missing
+- explicitly `false`
+- configured as an array whose primary option is not `true`
+
+## Why this rule exists
+
+Stylelint already ships a built-in config option for reporting disable comments that do not explain why a rule was turned off.
+
+Enabling that option improves review quality because disable comments stop being silent escapes with no context.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    reportDescriptionlessDisables: true,
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## Behavior and migration notes
+
+- Missing properties are autofixed by inserting `reportDescriptionlessDisables: true`.
+- `false` values are autofixed to `true`.
+- Array-form values preserve the secondary options object while rewriting the primary option to `true`.
+
+## Additional examples
+
+### ✅ Correct — keep secondary options
+
+```ts
+export default {
+    reportDescriptionlessDisables: [true, { severity: "warning" }],
+};
+```
+
+## ESLint flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configuration,
+];
+```
+
+## When not to use it
+
+Do not use this rule if your team intentionally allows undocumented Stylelint disable comments and does not want Stylelint to report them.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R003
+
+## Further reading
+
+- [Stylelint ignore-code guide](https://stylelint.io/user-guide/ignore-code/)
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#reportdescriptionlessdisables)

package/docs/rules/prefer-stylelint-report-invalid-scope-disables.md

@@ -0,0 +1,83 @@
+# prefer-stylelint-report-invalid-scope-disables
+
+Require enabling Stylelint's `reportInvalidScopeDisables` config option in authored Stylelint config files.
+
+## Targeted pattern scope
+
+This rule targets Stylelint config modules such as `stylelint.config.ts`, `stylelint.config.mjs`, and `.stylelintrc.js`.
+
+It focuses on top-level exported config objects, including configs wrapped in `defineConfig(...)`.
+
+## What this rule reports
+
+This rule reports Stylelint config objects when `reportInvalidScopeDisables` is:
+
+- missing
+- explicitly `false`
+- configured as an array whose primary option is not `true`
+
+## Why this rule exists
+
+Stylelint can report disable comments that reference rules outside the active config. That catches stale or mistyped disable comments that silently stop being meaningful.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    reportInvalidScopeDisables: true,
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## Behavior and migration notes
+
+- Missing properties are autofixed by inserting `reportInvalidScopeDisables: true`.
+- `false` values are autofixed to `true`.
+- Array-form values preserve secondary options while rewriting the primary option to `true`.
+
+## Additional examples
+
+### ✅ Correct — keep secondary options
+
+```ts
+export default {
+    reportInvalidScopeDisables: [true, { severity: "warning" }],
+};
+```
+
+## ESLint flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configuration,
+];
+```
+
+## When not to use it
+
+Do not use this rule if your team intentionally allows invalid-scope disable comments to pass silently.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R004
+
+## Further reading
+
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#reportinvalidscopedisables)
+- [Stylelint ignore-code guide](https://stylelint.io/user-guide/ignore-code/)

package/docs/rules/prefer-stylelint-report-needless-disables.md

@@ -0,0 +1,83 @@
+# prefer-stylelint-report-needless-disables
+
+Require enabling Stylelint's `reportNeedlessDisables` config option in authored Stylelint config files.
+
+## Targeted pattern scope
+
+This rule targets Stylelint config modules such as `stylelint.config.ts`, `stylelint.config.mjs`, and `.stylelintrc.js`.
+
+It focuses on top-level exported config objects, including configs wrapped in `defineConfig(...)`.
+
+## What this rule reports
+
+This rule reports Stylelint config objects when `reportNeedlessDisables` is:
+
+- missing
+- explicitly `false`
+- configured as an array whose primary option is not `true`
+
+## Why this rule exists
+
+Stylelint can report disable comments that do not suppress any active finding. That helps teams remove stale disable comments instead of letting them accumulate as dead configuration noise.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    reportNeedlessDisables: true,
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## Behavior and migration notes
+
+- Missing properties are autofixed by inserting `reportNeedlessDisables: true`.
+- `false` values are autofixed to `true`.
+- Array-form values preserve secondary options while rewriting the primary option to `true`.
+
+## Additional examples
+
+### ✅ Correct — keep secondary options
+
+```ts
+export default {
+    reportNeedlessDisables: [true, { severity: "warning" }],
+};
+```
+
+## ESLint flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configuration,
+];
+```
+
+## When not to use it
+
+Do not use this rule if your team intentionally allows needless disable comments to remain in place without reporting.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R005
+
+## Further reading
+
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#reportneedlessdisables)
+- [Stylelint ignore-code guide](https://stylelint.io/user-guide/ignore-code/)

package/docs/rules/prefer-stylelint-report-unscoped-disables.md

@@ -0,0 +1,83 @@
+# prefer-stylelint-report-unscoped-disables
+
+Require enabling Stylelint's `reportUnscopedDisables` config option in authored Stylelint config files.
+
+## Targeted pattern scope
+
+This rule targets Stylelint config modules such as `stylelint.config.ts`, `stylelint.config.mjs`, and `.stylelintrc.js`.
+
+It focuses on top-level exported config objects, including configs wrapped in `defineConfig(...)`.
+
+## What this rule reports
+
+This rule reports Stylelint config objects when `reportUnscopedDisables` is:
+
+- missing
+- explicitly `false`
+- configured as an array whose primary option is not `true`
+
+## Why this rule exists
+
+Stylelint can report disable comments that are not scoped to specific rules. Enabling that report helps teams avoid broad, ambiguous disable comments that hide more than they need to.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    reportUnscopedDisables: true,
+    rules: {
+        "color-no-invalid-hex": true,
+    },
+};
+```
+
+## Behavior and migration notes
+
+- Missing properties are autofixed by inserting `reportUnscopedDisables: true`.
+- `false` values are autofixed to `true`.
+- Array-form values preserve secondary options while rewriting the primary option to `true`.
+
+## Additional examples
+
+### ✅ Correct — keep secondary options
+
+```ts
+export default {
+    reportUnscopedDisables: [true, { severity: "warning" }],
+};
+```
+
+## ESLint flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configuration,
+];
+```
+
+## When not to use it
+
+Do not use this rule if your team intentionally allows broad unscoped disable comments without reporting them.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R006
+
+## Further reading
+
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#reportunscopeddisables)
+- [Stylelint ignore-code guide](https://stylelint.io/user-guide/ignore-code/)

package/docs/rules/presets/all.md

@@ -0,0 +1,39 @@
+# all
+
+`all` enables the stylesheet bridge plus the full configuration-rule catalog, including the more opinionated operational policy rules that `recommended` intentionally leaves out.
+
+## Flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    ...stylelint2.configs.all,
+];
+```
+
+## Related preset docs
+
+- [Presets overview](./index.md)
+- [Recommended preset](./recommended.md)
+- [Stylelint-only preset](./stylelint-only.md)
+- [Configuration-only preset](./configuration.md)
+
+## Notable rules in this preset
+
+For the exhaustive generated rule matrix, see [Presets overview](./index.md).
+
+| Rule                                                                                                                                                                     | Fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-: |
+| [`stylelint`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/stylelint)                                                                               |  🔧 |
+| [`prefer-stylelint-cache`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-cache)                                                     |  🔧 |
+| [`disallow-stylelint-default-severity`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-default-severity)                           |  🔧 |
+| [`prefer-stylelint-fix`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-fix)                                                         |  🔧 |
+| [`prefer-stylelint-formatter`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-formatter)                                             |  —  |
+| [`disallow-stylelint-ignore-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-disables)                             |  🔧 |
+| [`disallow-stylelint-ignore-files`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-files)                                   |  🔧 |
+| [`prefer-stylelint-define-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-define-config)                                     |  🔧 |
+| [`prefer-stylelint-report-descriptionless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-descriptionless-disables) |  🔧 |
+| [`prefer-stylelint-report-invalid-scope-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-invalid-scope-disables)     |  🔧 |
+| [`prefer-stylelint-report-needless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-needless-disables)               |  🔧 |
+| [`prefer-stylelint-report-unscoped-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-unscoped-disables)               |  🔧 |

package/docs/rules/presets/configs.md

@@ -0,0 +1,40 @@
+# configs
+
+Legacy alias page for the preferred `configuration` preset.
+
+Use [`stylelint2.configs.configuration`](./configuration.md) for new documentation and examples.
+
+`stylelint2.configs.configs` remains supported as a backwards-compatible alias.
+
+## Flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configs,
+];
+```
+
+## Preferred docs
+
+- [Configuration-only preset](./configuration.md)
+- [Presets overview](./index.md)
+
+## Notable rules in this preset
+
+For the exhaustive generated rule matrix, see [Configuration-only preset](./configuration.md) and [Presets overview](./index.md).
+
+| Rule                                                                                                                                                                     | Fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-: |
+| [`prefer-stylelint-cache`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-cache)                                                     |  🔧 |
+| [`disallow-stylelint-default-severity`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-default-severity)                           |  🔧 |
+| [`prefer-stylelint-fix`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-fix)                                                         |  🔧 |
+| [`prefer-stylelint-formatter`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-formatter)                                             |  —  |
+| [`disallow-stylelint-ignore-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-disables)                             |  🔧 |
+| [`disallow-stylelint-ignore-files`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-files)                                   |  🔧 |
+| [`prefer-stylelint-define-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-define-config)                                     |  🔧 |
+| [`prefer-stylelint-report-descriptionless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-descriptionless-disables) |  🔧 |
+| [`prefer-stylelint-report-invalid-scope-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-invalid-scope-disables)     |  🔧 |
+| [`prefer-stylelint-report-needless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-needless-disables)               |  🔧 |
+| [`prefer-stylelint-report-unscoped-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-unscoped-disables)               |  🔧 |

package/docs/rules/presets/configuration.md

@@ -0,0 +1,64 @@
+# configuration
+
+Enable only the full Stylelint configuration-authoring workflow.
+
+Use this preset when you want to lint `stylelint.config.*` and `.stylelintrc.*` files for config hygiene, but you do **not** want the stylesheet bridge, source CSS linting, or Stylelint autofix bridging enabled in the same preset.
+
+## Flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.configuration,
+];
+```
+
+> Legacy alias: `stylelint2.configs.configs` remains supported for backwards compatibility.
+
+## What this preset includes
+
+- `stylelint-2/prefer-stylelint-cache`
+- `stylelint-2/disallow-stylelint-default-severity`
+- `stylelint-2/prefer-stylelint-fix`
+- `stylelint-2/prefer-stylelint-formatter`
+- `stylelint-2/disallow-stylelint-ignore-disables`
+- `stylelint-2/disallow-stylelint-ignore-files`
+- `stylelint-2/prefer-stylelint-define-config`
+- `stylelint-2/prefer-stylelint-report-descriptionless-disables`
+- `stylelint-2/prefer-stylelint-report-invalid-scope-disables`
+- `stylelint-2/prefer-stylelint-report-needless-disables`
+- `stylelint-2/prefer-stylelint-report-unscoped-disables`
+- `stylelint-2/require-stylelint-overrides-configuration`
+- `stylelint-2/require-stylelint-overrides-files-array`
+
+## What this preset does not include
+
+- No CSS `stylelint-2/stylelint` bridge rule
+- No stylesheet linting for `**/*.css`
+- No Stylelint autofix bridge for source CSS files
+
+## Related preset docs
+
+- [Presets overview](./index.md)
+- [Recommended preset](./recommended.md)
+- [Stylelint-only preset](./stylelint-only.md)
+- [All preset](./all.md)
+
+## Notable rules in this preset
+
+For the exhaustive generated rule matrix, see [Presets overview](./index.md).
+
+| Rule                                                                                                                                                                     | Fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-: |
+| [`prefer-stylelint-cache`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-cache)                                                     |  🔧 |
+| [`disallow-stylelint-default-severity`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-default-severity)                           |  🔧 |
+| [`prefer-stylelint-fix`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-fix)                                                         |  🔧 |
+| [`prefer-stylelint-formatter`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-formatter)                                             |  —  |
+| [`disallow-stylelint-ignore-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-disables)                             |  🔧 |
+| [`disallow-stylelint-ignore-files`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-files)                                   |  🔧 |
+| [`prefer-stylelint-define-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-define-config)                                     |  🔧 |
+| [`prefer-stylelint-report-descriptionless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-descriptionless-disables) |  🔧 |
+| [`prefer-stylelint-report-invalid-scope-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-invalid-scope-disables)     |  🔧 |
+| [`prefer-stylelint-report-needless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-needless-disables)               |  🔧 |
+| [`prefer-stylelint-report-unscoped-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-unscoped-disables)               |  🔧 |

package/docs/rules/presets/index.md

@@ -0,0 +1,82 @@
+---
+title: Presets
+description: Preset reference for eslint-plugin-stylelint-2.
+---
+
+# Presets
+
+The plugin currently exposes four presets:
+
+- `stylelint2.configs.recommended`
+- `stylelint2.configs.stylelintOnly`
+- `stylelint2.configs.configuration`
+- `stylelint2.configs.all`
+
+Legacy aliases remain available:
+
+- `stylelint2.configs.stylesheets` → `stylelint2.configs.stylelintOnly`
+- `stylelint2.configs.configs` → `stylelint2.configs.configuration`
+
+## Preset setup guides
+
+Use the setup page for the preset you want to enable:
+
+| Preset                                                    | Purpose                                                                                               | Setup page                                            |
+| --------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
+| [`stylelint2.configs.recommended`](./recommended.md)      | Enable both stylesheet linting and Stylelint config authoring guidance.                               | [Recommended preset guide](./recommended.md)          |
+| [`stylelint2.configs.stylelintOnly`](./stylelint-only.md) | Enable only the Stylelint bridge workflow for stylesheets and ESLint-side autofix.                    | [Stylelint-only preset guide](./stylelint-only.md)    |
+| [`stylelint2.configs.configuration`](./configuration.md)  | Lint only Stylelint config modules and disable-comment reporting settings, with no stylesheet bridge. | [Configuration-only preset guide](./configuration.md) |
+| [`stylelint2.configs.all`](./all.md)                      | Enable every preset entry currently shipped by this plugin.                                           | [All preset guide](./all.md)                          |
+
+## Rule matrix
+
+Fix legend:
+- `🔧` = autofixable
+- `—` = report only
+
+Preset key legend:
+  - [`🟡`](./recommended.md) — [`stylelint2.configs.recommended`](./recommended.md)
+  - [`🎨`](./stylelint-only.md) — [`stylelint2.configs.stylelintOnly`](./stylelint-only.md)
+  - [`🔧`](./configuration.md) — [`stylelint2.configs.configuration`](./configuration.md)
+  - [`🟣`](./all.md) — [`stylelint2.configs.all`](./all.md)
+
+| Rule | Fix | Preset key |
+| --- | :-: | :-- |
+| [`stylelint`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/stylelint) | 🔧 | [🟡](./recommended.md) [🎨](./stylelint-only.md) [🟣](./all.md) |
+| [`disallow-stylelint-allow-empty-input`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-allow-empty-input) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-configuration-comment`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-configuration-comment) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-custom-syntax`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-custom-syntax) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-default-severity`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-default-severity) | 🔧 | [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-duplicate-extends`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-duplicate-extends) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-duplicate-plugins`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-duplicate-plugins) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-duplicate-rule-option-values`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-duplicate-rule-option-values) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-empty-rules-object`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-empty-rules-object) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-ignore-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-disables) | 🔧 | [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-ignore-files`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-ignore-files) | 🔧 | [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-null-rule-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-null-rule-config) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-overrides-runtime-options`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-overrides-runtime-options) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-processors`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-processors) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-relative-extends-paths`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-relative-extends-paths) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`disallow-stylelint-relative-plugin-paths`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/disallow-stylelint-relative-plugin-paths) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-cache`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-cache) | 🔧 | [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-define-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-define-config) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-extends-array`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-extends-array) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-fix`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-fix) | 🔧 | [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-formatter`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-formatter) | — | [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-plugins-array`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-plugins-array) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-report-descriptionless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-descriptionless-disables) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-report-invalid-scope-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-invalid-scope-disables) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-report-needless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-needless-disables) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`prefer-stylelint-report-unscoped-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-unscoped-disables) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-custom-syntax-in-overrides`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-custom-syntax-in-overrides) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-config-file-naming-convention`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-config-file-naming-convention) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-extends-packages-installed`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-extends-packages-installed) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-overrides-configuration`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-overrides-configuration) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-overrides-files-array`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-overrides-files-array) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-overrides-files`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-overrides-files) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-plugins-packages-installed`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-plugins-packages-installed) | — | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-report-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-report-disables) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`require-stylelint-rules-object`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/require-stylelint-rules-object) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`sort-stylelint-extends`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/sort-stylelint-extends) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`sort-stylelint-plugins`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/sort-stylelint-plugins) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |
+| [`sort-stylelint-rule-keys`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/sort-stylelint-rule-keys) | 🔧 | [🟡](./recommended.md) [🔧](./configuration.md) [🟣](./all.md) |

package/docs/rules/presets/recommended.md

@@ -0,0 +1,40 @@
+# recommended
+
+Enable both primary workflows in `eslint-plugin-stylelint-2`:
+
+- run the Stylelint bridge from ESLint for stylesheet files
+- enforce the broadly useful Stylelint configuration-authoring rules in config modules
+
+Use this preset when you want the default rollout path without opting into every operational or repository-specific Stylelint config preference.
+
+`recommended` intentionally leaves out the more opinionated policy rules around cache defaults, formatter defaults, autofix defaults, global ignore globs, disable-comment bypasses, and global default severity.
+
+## Flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    ...stylelint2.configs.recommended,
+];
+```
+
+## Related preset docs
+
+- [Presets overview](./index.md)
+- [Stylelint-only preset](./stylelint-only.md)
+- [Configuration-only preset](./configuration.md)
+- [All preset](./all.md)
+
+## Notable rules in this preset
+
+For the exhaustive generated rule matrix, see [Presets overview](./index.md).
+
+| Rule                                                                                                                                                                     | Fix |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | :-: |
+| [`stylelint`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/stylelint)                                                                               |  🔧 |
+| [`prefer-stylelint-define-config`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-define-config)                                     |  🔧 |
+| [`prefer-stylelint-report-descriptionless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-descriptionless-disables) |  🔧 |
+| [`prefer-stylelint-report-invalid-scope-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-invalid-scope-disables)     |  🔧 |
+| [`prefer-stylelint-report-needless-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-needless-disables)               |  🔧 |
+| [`prefer-stylelint-report-unscoped-disables`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/prefer-stylelint-report-unscoped-disables)               |  🔧 |

package/docs/rules/presets/stylelint-only.md

@@ -0,0 +1,42 @@
+# stylelintOnly
+
+Enable only the stylesheet-facing Stylelint bridge workflow.
+
+This preset is the clearest choice when you want Stylelint diagnostics and autofixes to flow through ESLint, but you do **not** want any Stylelint config-authoring rules in the same preset.
+
+## Flat config example
+
+```ts
+import stylelint2 from "eslint-plugin-stylelint-2";
+
+export default [
+    stylelint2.configs.stylelintOnly,
+];
+```
+
+> Legacy alias: `stylelint2.configs.stylesheets` remains supported for backwards compatibility.
+
+## What this preset includes
+
+- `stylelint-2/stylelint`
+- stylesheet files only (`**/*.css`)
+- Stylelint edit info surfaced through `eslint --fix` when available
+
+## What this preset does not include
+
+- No Stylelint config-module rules
+- No `defineConfig()` authoring checks
+- No disable-comment reporting checks for config files
+
+## Related preset docs
+
+- [Presets overview](./index.md)
+- [Recommended preset](./recommended.md)
+- [Configuration-only preset](./configuration.md)
+- [All preset](./all.md)
+
+## Rules in this preset
+
+| Rule                                                                                       | Fix |
+| ------------------------------------------------------------------------------------------ | :-: |
+| [`stylelint`](https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/stylelint) |  🔧 |