@icebreakers/eslint-config 1.6.31 → 2.0.0

package/README.md

@@ -10,7 +10,7 @@
 
 - Node.js 18 or newer
 - ESLint 9 with flat config support
-- Install optional peer plugins when you turn on Tailwind (`eslint-plugin-tailwindcss` or `eslint-plugin-better-tailwindcss`), MDX (`eslint-plugin-mdx`), or UnoCSS (`@unocss/eslint-plugin`)
+- Install optional peer plugins when you turn on Tailwind (`eslint-plugin-tailwindcss` or `eslint-plugin-better-tailwindcss`), MDX (`eslint-plugin-mdx`), Stylelint bridge (`eslint-plugin-better-stylelint`), or UnoCSS (`@unocss/eslint-plugin`)
 
 ## Installation
 
@@ -72,6 +72,27 @@ export default icebreaker({
 - `formatters` – keeps the built-in formatting rules enabled by default.
 - `test` – relaxes certain Vitest/Jest style rules (`test/prefer-lowercase-title`).
 
+### Stylelint Bridge
+
+Set `stylelint: true` to bridge Stylelint diagnostics into ESLint for
+`*.css`, `*.scss`, and `.vue` style blocks:
+
+```bash
+pnpm add -D eslint-plugin-better-stylelint
+```
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: true,
+})
+```
+
+You can also pass `stylelint: { cwd: '/path/to/project' }` if Stylelint should
+resolve its config from a different working directory.
+
 ### NestJS Projects
 
 Enable `nestjs: true` together with the TypeScript preset to apply rules tailored for Nest idioms:

package/README.zh.md

@@ -8,7 +8,7 @@
 
 - Node.js 18 或更高版本
 - 支持 Flat Config 的 ESLint 9
-- 如需启用 Tailwind、MDX、UnoCSS 等，可安装对应的可选依赖：`eslint-plugin-tailwindcss` / `eslint-plugin-better-tailwindcss`、`eslint-plugin-mdx`、`@unocss/eslint-plugin`
+- 如需启用 Tailwind、MDX、Stylelint 桥接、UnoCSS 等，可安装对应的可选依赖：`eslint-plugin-tailwindcss` / `eslint-plugin-better-tailwindcss`、`eslint-plugin-mdx`、`eslint-plugin-better-stylelint`、`@unocss/eslint-plugin`
 
 ## 安装
 
@@ -70,6 +70,39 @@ export default icebreaker({
 - `formatters`：默认启用格式化辅助规则。
 - `test`：放宽 Vitest / Jest 常见规则，例如关闭 `test/prefer-lowercase-title`。
 
+### Stylelint 桥接
+
+设置 `stylelint: true` 后，会把 Stylelint 诊断桥接到 ESLint，用于：
+
+- `*.css`
+- `*.scss`
+- `.vue` 文件里的 `<style>` 块
+
+```bash
+pnpm add -D eslint-plugin-better-stylelint
+```
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: true,
+})
+```
+
+如果 Stylelint 需要从其它目录解析配置，也可以传：
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  stylelint: {
+    cwd: '/path/to/project',
+  },
+})
+```
+
 ### NestJS 项目
 
 建议在 Nest 项目中同时开启 `typescript` 与 `nestjs`，以便应用以下定制：

package/dist/index.cjs

@@ -170,6 +170,34 @@ function resolveTailwindPresets(option) {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
 }
+function resolveStylelintBridgePresets(option) {
+	if (!option) return [];
+	const stylelintOptions = typeof option === "object" ? option : {};
+	const pluginPromise = (0, antfu_exports.interopDefault)(import("eslint-plugin-better-stylelint"));
+	return [
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.{css,pcss,postcss}"],
+				plugins: { stylelint: plugin },
+				processor: "stylelint/css"
+			};
+		}),
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.{scss,sass}"],
+				plugins: { stylelint: plugin },
+				processor: "stylelint/scss"
+			};
+		}),
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.vue"],
+				plugins: { stylelint: plugin },
+				rules: { "stylelint/stylelint": ["error", stylelintOptions] }
+			};
+		})
+	];
+}
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
@@ -431,8 +459,11 @@ function createBaseRuleSet(isLegacy) {
 //#region src/preset.ts
 function getPresets(options, mode) {
 	const resolved = resolveUserOptions(options);
-	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }];
-	presets.push(...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
+	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }, {
+		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
+		rules: { "style/eol-last": "off" }
+	}];
+	presets.push(...resolveStylelintBridgePresets(resolved.stylelint), ...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
 	return [resolved, ...presets];
 }
 //#endregion

package/dist/index.d.cts

@@ -2922,12 +2922,20 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
+type StylelintBridgeConfig = boolean | {
+  cwd?: string;
+};
 type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
   /**
    * Enable TailwindCSS support
    * @default false
    */
   tailwindcss?: TailwindcssConfig;
+  /**
+   * Bridge Stylelint diagnostics into ESLint for style files.
+   * @default false
+   */
+  stylelint?: StylelintBridgeConfig;
   /**
    * Enable MDX support
    * @default false

package/dist/index.d.ts

@@ -2922,12 +2922,20 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
+type StylelintBridgeConfig = boolean | {
+  cwd?: string;
+};
 type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
   /**
    * Enable TailwindCSS support
    * @default false
    */
   tailwindcss?: TailwindcssConfig;
+  /**
+   * Bridge Stylelint diagnostics into ESLint for style files.
+   * @default false
+   */
+  stylelint?: StylelintBridgeConfig;
   /**
    * Enable MDX support
    * @default false

package/dist/index.js

@@ -161,6 +161,34 @@ function resolveTailwindPresets(option) {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
 }
+function resolveStylelintBridgePresets(option) {
+	if (!option) return [];
+	const stylelintOptions = typeof option === "object" ? option : {};
+	const pluginPromise = (0, antfu_exports.interopDefault)(import("eslint-plugin-better-stylelint"));
+	return [
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.{css,pcss,postcss}"],
+				plugins: { stylelint: plugin },
+				processor: "stylelint/css"
+			};
+		}),
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.{scss,sass}"],
+				plugins: { stylelint: plugin },
+				processor: "stylelint/scss"
+			};
+		}),
+		pluginPromise.then((plugin) => {
+			return {
+				files: ["**/*.vue"],
+				plugins: { stylelint: plugin },
+				rules: { "stylelint/stylelint": ["error", stylelintOptions] }
+			};
+		})
+	];
+}
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
@@ -422,8 +450,11 @@ function createBaseRuleSet(isLegacy) {
 //#region src/preset.ts
 function getPresets(options, mode) {
 	const resolved = resolveUserOptions(options);
-	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }];
-	presets.push(...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
+	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }, {
+		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
+		rules: { "style/eol-last": "off" }
+	}];
+	presets.push(...resolveStylelintBridgePresets(resolved.stylelint), ...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
 	return [resolved, ...presets];
 }
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/eslint-config",
   "type": "module",
-  "version": "1.6.31",
+  "version": "2.0.0",
   "description": "ESLint preset from Icebreaker's dev-configs",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -34,9 +34,13 @@
     "index.d.ts"
   ],
   "peerDependencies": {
-    "eslint-plugin-pnpm": "^1.4.3"
+    "eslint-plugin-pnpm": "^1.4.3",
+    "eslint-plugin-better-stylelint": "0.1.0"
   },
   "peerDependenciesMeta": {
+    "eslint-plugin-better-stylelint": {
+      "optional": true
+    },
     "eslint-plugin-pnpm": {
       "optional": true
     }
@@ -44,8 +48,8 @@
   "dependencies": {
     "@antfu/eslint-config": "7.7.3",
     "@eslint-react/eslint-plugin": "^3.0.0",
-    "@next/eslint-plugin-next": "^16.1.7",
-    "@tanstack/eslint-plugin-query": "^5.91.4",
+    "@next/eslint-plugin-next": "^16.2.0",
+    "@tanstack/eslint-plugin-query": "^5.91.5",
     "eslint-plugin-better-tailwindcss": "^4.3.2",
     "eslint-plugin-format": "2.0.1",
     "eslint-plugin-jsx-a11y": "^6.10.2",
@@ -55,7 +59,7 @@
     "eslint-plugin-vuejs-accessibility": "^2.5.0"
   },
   "optionalDependencies": {
-    "@unocss/eslint-plugin": "66.6.6",
+    "@unocss/eslint-plugin": "66.6.7",
     "eslint-plugin-mdx": "3.7.0"
   },
   "publishConfig": {