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

export default {
    rules: {
        "color-no-invalid-hex": true,
    },
};

✅ Correct

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

export default {
    reportUnscopedDisables: [true, { severity: "warning" }],
};

ESLint flat config example

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

Targeted pattern scope​

What this rule reports​

Why this rule exists​

❌ Incorrect​

✅ Correct​

Behavior and migration notes​

Additional examples​

✅ Correct — keep secondary options​

ESLint flat config example​

When not to use it​

Package documentation​

Further reading​