eslint-plugin-stylelint-2 1.0.9

package/dist/rules/sort-stylelint-rule-keys.js

@@ -0,0 +1,129 @@
+import { getExportedStylelintConfigObject, isStylelintConfigFile, } from "../_internal/stylelint-config-object.js";
+import { getTopLevelRuleEntries, getTopLevelRulesObject, } from "../_internal/stylelint-config-rules-object.js";
+import { createTypedRule, toRuleListener } from "../_internal/typed-rule.js";
+const getRuleName = (property) => {
+    const propertyKey = property.key;
+    if (propertyKey.type === "Identifier") {
+        return propertyKey.name;
+    }
+    if (propertyKey.type === "Literal" &&
+        typeof propertyKey.value === "string") {
+        return propertyKey.value;
+    }
+    return undefined;
+};
+const isAlreadySorted = (properties) => {
+    let previousRuleName = "";
+    for (const property of properties) {
+        const ruleName = getRuleName(property);
+        if (ruleName === undefined) {
+            return true;
+        }
+        if (ruleName.localeCompare(previousRuleName) < 0) {
+            return false;
+        }
+        previousRuleName = ruleName;
+    }
+    return true;
+};
+const canSafelyFixSorting = (sourceCode, properties) => {
+    for (const property of properties) {
+        if (property.computed || property.kind !== "init") {
+            return false;
+        }
+        if (getRuleName(property) === undefined) {
+            return false;
+        }
+        if (sourceCode.getCommentsBefore(property).length > 0) {
+            return false;
+        }
+        if (sourceCode.getCommentsAfter(property).length > 0) {
+            return false;
+        }
+    }
+    return true;
+};
+const getSortedPropertyText = (sourceCode, properties) => {
+    const sortedProperties = [...properties];
+    sortedProperties.sort((left, right) => {
+        const leftRuleName = getRuleName(left) ?? "";
+        const rightRuleName = getRuleName(right) ?? "";
+        return leftRuleName.localeCompare(rightRuleName);
+    });
+    const indentation = " ".repeat(properties[0]?.loc.start.column ?? 0);
+    return sortedProperties
+        .map((property) => sourceCode.getText(property))
+        .join(`,\n${indentation}`);
+};
+/** Rule module that enforces lexical ordering of top-level Stylelint rule keys. */
+const sortStylelintRuleKeysRule = createTypedRule({
+    create(context) {
+        if (!isStylelintConfigFile(context.physicalFilename)) {
+            return {};
+        }
+        const sourceCode = context.sourceCode;
+        return toRuleListener({
+            ExportDefaultDeclaration(node) {
+                if (node === null || typeof node !== "object") {
+                    return;
+                }
+                const exportDefaultNode = node;
+                const configObject = getExportedStylelintConfigObject(exportDefaultNode.declaration);
+                if (configObject === undefined) {
+                    return;
+                }
+                const rulesObject = getTopLevelRulesObject(configObject);
+                if (rulesObject === undefined) {
+                    return;
+                }
+                const ruleEntries = getTopLevelRuleEntries(rulesObject);
+                if (ruleEntries.length < 2 ||
+                    isAlreadySorted(ruleEntries)) {
+                    return;
+                }
+                context.report({
+                    fix(fixer) {
+                        if (!canSafelyFixSorting(sourceCode, ruleEntries)) {
+                            return null;
+                        }
+                        const firstRuleEntry = ruleEntries[0];
+                        const lastRuleEntry = ruleEntries.at(-1);
+                        if (firstRuleEntry === undefined ||
+                            lastRuleEntry === undefined) {
+                            return null;
+                        }
+                        return fixer.replaceTextRange([
+                            firstRuleEntry.range[0],
+                            lastRuleEntry.range[1],
+                        ], getSortedPropertyText(sourceCode, ruleEntries));
+                    },
+                    messageId: "sortRuleKeys",
+                    node: rulesObject,
+                });
+            },
+        });
+    },
+    meta: {
+        deprecated: false,
+        docs: {
+            configs: [
+                "stylelint2.configs.recommended",
+                "stylelint2.configs.configuration",
+                "stylelint2.configs.all",
+            ],
+            description: "enforce sorted top-level Stylelint rule keys in shared config files.",
+            recommended: true,
+            requiresTypeChecking: false,
+            url: "https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/sort-stylelint-rule-keys",
+        },
+        fixable: "code",
+        messages: {
+            sortRuleKeys: "Sort top-level Stylelint `rules` keys for deterministic diffs and consistent review order.",
+        },
+        schema: [],
+        type: "suggestion",
+    },
+    name: "sort-stylelint-rule-keys",
+});
+export default sortStylelintRuleKeysRule;
+//# sourceMappingURL=sort-stylelint-rule-keys.js.map

package/dist/rules/sort-stylelint-rule-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-stylelint-rule-keys.js","sourceRoot":"","sources":["../../src/rules/sort-stylelint-rule-keys.ts"],"names":[],"mappings":"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"}

package/dist/rules/stylelint.d.ts

@@ -0,0 +1,15 @@
+import { type RuleModuleWithDocs } from "../_internal/typed-rule.js";
+type MessageIds = "stylelintConfigWarning" | "stylelintParseError" | "stylelintProblem";
+type Options = readonly [StylelintRuleOption?];
+type StylelintRuleOption = Readonly<{
+    allowEmptyInput?: boolean;
+    configBasedir?: string;
+    configFile?: string;
+    customSyntax?: string;
+    ignoreDisables?: boolean;
+    quiet?: boolean;
+}>;
+/** Rule module that bridges Stylelint diagnostics into ESLint. */
+declare const stylelintRule: RuleModuleWithDocs<MessageIds, Options>;
+export default stylelintRule;
+//# sourceMappingURL=stylelint.d.ts.map

package/dist/rules/stylelint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylelint.d.ts","sourceRoot":"","sources":["../../src/rules/stylelint.ts"],"names":[],"mappings":"AAOA,OAAO,EAGH,KAAK,kBAAkB,EAE1B,MAAM,4BAA4B,CAAC;AAEpC,KAAK,UAAU,GACT,wBAAwB,GACxB,qBAAqB,GACrB,kBAAkB,CAAC;AAEzB,KAAK,OAAO,GAAG,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAO/C,KAAK,mBAAmB,GAAG,QAAQ,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAoBH,kEAAkE;AAClE,QAAA,MAAM,aAAa,EAAE,kBAAkB,CAAC,UAAU,EAAE,OAAO,CAmKzD,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/dist/rules/stylelint.js

@@ -0,0 +1,157 @@
+import { runStylelintSynchronously } from "../_internal/stylelint-runner.js";
+import { createTypedRule, replaceTextRange, toRuleListener, } from "../_internal/typed-rule.js";
+const toEslintLoc = (problem) => ({
+    end: {
+        column: Math.max((problem.endColumn ?? problem.column + 1) - 1, 0),
+        line: problem.endLine ?? problem.line,
+    },
+    start: {
+        column: Math.max(problem.column - 1, 0),
+        line: problem.line,
+    },
+});
+/** Rule module that bridges Stylelint diagnostics into ESLint. */
+const stylelintRule = createTypedRule({
+    create(context, [rawOptions = {}]) {
+        return toRuleListener({
+            StyleSheet() {
+                const sourceCode = context.sourceCode;
+                const lintResult = runStylelintSynchronously({
+                    code: sourceCode.text,
+                    codeFilename: context.physicalFilename,
+                    cwd: context.cwd,
+                    ...(rawOptions.allowEmptyInput === undefined
+                        ? {}
+                        : { allowEmptyInput: rawOptions.allowEmptyInput }),
+                    ...(rawOptions.configBasedir === undefined
+                        ? {}
+                        : { configBasedir: rawOptions.configBasedir }),
+                    ...(rawOptions.configFile === undefined
+                        ? {}
+                        : { configFile: rawOptions.configFile }),
+                    ...(rawOptions.customSyntax === undefined
+                        ? {}
+                        : { customSyntax: rawOptions.customSyntax }),
+                    ...(rawOptions.ignoreDisables === undefined
+                        ? {}
+                        : { ignoreDisables: rawOptions.ignoreDisables }),
+                    ...(rawOptions.quiet === undefined
+                        ? {}
+                        : { quiet: rawOptions.quiet }),
+                });
+                const reportNode = sourceCode.ast;
+                for (const parseError of lintResult.parseErrors) {
+                    context.report({
+                        data: {
+                            message: parseError.message,
+                        },
+                        loc: toEslintLoc(parseError),
+                        messageId: "stylelintParseError",
+                        node: reportNode,
+                    });
+                }
+                for (const warning of lintResult.warnings) {
+                    const fixData = warning.fix;
+                    context.report({
+                        data: {
+                            rule: warning.rule,
+                            text: warning.text,
+                        },
+                        loc: toEslintLoc(warning),
+                        messageId: "stylelintProblem",
+                        node: reportNode,
+                        ...(fixData === undefined
+                            ? {}
+                            : {
+                                fix: (fixer) => replaceTextRange(fixer, fixData.range, fixData.text),
+                            }),
+                    });
+                }
+                for (const invalidOptionWarning of lintResult.invalidOptionWarnings) {
+                    context.report({
+                        data: {
+                            message: invalidOptionWarning,
+                        },
+                        loc: {
+                            end: { column: 0, line: 1 },
+                            start: { column: 0, line: 1 },
+                        },
+                        messageId: "stylelintConfigWarning",
+                        node: reportNode,
+                    });
+                }
+                for (const deprecation of lintResult.deprecations) {
+                    context.report({
+                        data: {
+                            message: deprecation,
+                        },
+                        loc: {
+                            end: { column: 0, line: 1 },
+                            start: { column: 0, line: 1 },
+                        },
+                        messageId: "stylelintConfigWarning",
+                        node: reportNode,
+                    });
+                }
+            },
+        });
+    },
+    meta: {
+        defaultOptions: [{}],
+        deprecated: false,
+        docs: {
+            configs: [
+                "stylelint2.configs.recommended",
+                "stylelint2.configs.stylelintOnly",
+                "stylelint2.configs.all",
+            ],
+            description: "enforce running Stylelint against CSS files from ESLint and surface Stylelint autofixes through ESLint's fixer pipeline.",
+            recommended: true,
+            requiresTypeChecking: false,
+            url: "https://nick2bad4u.github.io/eslint-plugin-stylelint-2/docs/rules/stylelint",
+        },
+        fixable: "code",
+        messages: {
+            stylelintConfigWarning: "Stylelint configuration warning: {{message}}",
+            stylelintParseError: "Stylelint parse error: {{message}}",
+            stylelintProblem: "Stylelint ({{rule}}): {{text}}",
+        },
+        schema: [
+            {
+                additionalProperties: false,
+                description: "Optional Stylelint bridge settings forwarded to the Stylelint Node API.",
+                properties: {
+                    allowEmptyInput: {
+                        description: "Allow empty input when forwarding the file to Stylelint.",
+                        type: "boolean",
+                    },
+                    configBasedir: {
+                        description: "Base directory used when resolving relative paths from the chosen Stylelint config.",
+                        type: "string",
+                    },
+                    configFile: {
+                        description: "Explicit Stylelint config file path to use instead of normal config discovery.",
+                        type: "string",
+                    },
+                    customSyntax: {
+                        description: "Optional Stylelint custom syntax package name.",
+                        type: "string",
+                    },
+                    ignoreDisables: {
+                        description: "Ignore Stylelint disable comments while linting the file.",
+                        type: "boolean",
+                    },
+                    quiet: {
+                        description: "Suppress warning-level Stylelint messages.",
+                        type: "boolean",
+                    },
+                },
+                type: "object",
+            },
+        ],
+        type: "layout",
+    },
+    name: "stylelint",
+});
+export default stylelintRule;
+//# sourceMappingURL=stylelint.js.map

package/dist/rules/stylelint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylelint.js","sourceRoot":"","sources":["../../src/rules/stylelint.ts"],"names":[],"mappings":"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"}

package/docs/rules/disallow-stylelint-allow-empty-input.md

@@ -0,0 +1,62 @@
+# disallow-stylelint-allow-empty-input
+
+Disallow configuring Stylelint's top-level `allowEmptyInput` option inside 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 that include a top-level `allowEmptyInput` property.
+
+## Why this rule exists
+
+`allowEmptyInput` changes runtime behavior for file discovery and no-op lint runs. That policy is an execution concern and should be controlled at invocation level, not embedded in shared config state.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    allowEmptyInput: true,
+    rules: {},
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    rules: {},
+};
+```
+
+## Behavior and migration notes
+
+- This rule removes the top-level `allowEmptyInput` property.
+- It preserves the rest of the config object.
+- Prefer explicit file globs and task-level invocation behavior for empty-input handling.
+
+## 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 enforces one shared `allowEmptyInput` policy in committed Stylelint config files.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R013
+
+## Further reading
+
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#allowemptyinput)

package/docs/rules/disallow-stylelint-configuration-comment.md

@@ -0,0 +1,62 @@
+# disallow-stylelint-configuration-comment
+
+Disallow configuring Stylelint's top-level `configurationComment` option inside 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 that include a top-level `configurationComment` property.
+
+## Why this rule exists
+
+`configurationComment` changes how in-source configuration comments are interpreted. In shared configs, overriding this can create hard-to-debug behavior differences across repositories and tooling.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    configurationComment: "stylelint-enable",
+    rules: {},
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    rules: {},
+};
+```
+
+## Behavior and migration notes
+
+- This rule removes top-level `configurationComment`.
+- It preserves the rest of the config object.
+- Keep configuration-comment behavior aligned with Stylelint defaults unless there is a strict organization-wide policy.
+
+## 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 organization explicitly standardizes a non-default Stylelint configuration comment token.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R016
+
+## Further reading
+
+- [Stylelint configuration comments](https://stylelint.io/user-guide/ignore-code/)

package/docs/rules/disallow-stylelint-custom-syntax.md

@@ -0,0 +1,70 @@
+# disallow-stylelint-custom-syntax
+
+Disallow configuring Stylelint's top-level `customSyntax` option inside 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 that include a top-level `customSyntax` property.
+
+## Why this rule exists
+
+Top-level `customSyntax` applies globally and can accidentally affect unrelated file types. Syntax selection is safer when scoped to `overrides` entries with explicit `files` matchers.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    customSyntax: "postcss-scss",
+    rules: {},
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    overrides: [
+        {
+            customSyntax: "postcss-scss",
+            files: ["**/*.scss"],
+            rules: {},
+        },
+    ],
+    rules: {},
+};
+```
+
+## Behavior and migration notes
+
+- This rule removes top-level `customSyntax`.
+- It preserves the rest of the config object.
+- Move syntax declarations into override entries that include explicit file patterns.
+
+## 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 repository intentionally uses one global syntax parser for every linted file.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R014
+
+## Further reading
+
+- [Stylelint customSyntax](https://stylelint.io/user-guide/configure/#customsyntax)
+- [Stylelint overrides](https://stylelint.io/user-guide/configure/#overrides)

package/docs/rules/disallow-stylelint-default-severity.md

@@ -0,0 +1,77 @@
+# disallow-stylelint-default-severity
+
+Disallow configuring Stylelint's top-level `defaultSeverity` option inside 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 that include a top-level `defaultSeverity` property.
+
+## Why this rule exists
+
+`defaultSeverity` applies a global warning/error policy across rules. In an ESLint-first workflow, that global Stylelint severity layer can conflict with the severity contract already defined at the ESLint rule boundary.
+
+Keeping severity explicit per Stylelint rule (or enforced at the ESLint config layer) makes review outcomes easier to reason about and avoids hidden global severity drift.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    defaultSeverity: "warning",
+    rules: {},
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    rules: {},
+};
+```
+
+## Behavior and migration notes
+
+- This rule removes the top-level `defaultSeverity` property.
+- It preserves the rest of the config object.
+- If you need warning/error policy differences, keep them explicit in rule-level secondary options or the ESLint config that enables this plugin.
+
+## Additional examples
+
+### ✅ Correct — severity stays local to a rule
+
+```ts
+export default {
+    rules: {
+        "number-max-precision": [2, { 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 enforces one global Stylelint default severity in committed config and accepts that policy being coupled to shared config files.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R009
+
+## Further reading
+
+- [Stylelint configuring guide](https://stylelint.io/user-guide/configure/#defaultseverity)
+- [Stylelint severity option](https://stylelint.io/user-guide/configure/#severity)

package/docs/rules/disallow-stylelint-duplicate-extends.md

@@ -0,0 +1,61 @@
+# disallow-stylelint-duplicate-extends
+
+Disallow duplicate entries in top-level Stylelint `extends` declarations.
+
+## 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
+
+Reports duplicate string entries in top-level `extends` arrays.
+
+## Why this rule exists
+
+Duplicate shared-config layers add noise and can obscure real config intent.
+
+## ❌ Incorrect
+
+```ts
+export default {
+    extends: ["stylelint-config-standard", "stylelint-config-standard"],
+    rules: {},
+};
+```
+
+## ✅ Correct
+
+```ts
+export default {
+    extends: ["stylelint-config-standard"],
+    rules: {},
+};
+```
+
+## Behavior and migration notes
+
+This rule auto-fixes by keeping the first occurrence of each entry.
+
+## 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 repository intentionally keeps duplicate entries for generated tooling compatibility.
+
+## Package documentation
+
+Stylelint package documentation:
+
+> **Rule catalog ID:** R023
+
+## Further reading
+
+- [Stylelint extends](https://stylelint.io/user-guide/configure/#extends)