@icebreakers/eslint-config 1.6.33 → 2.0.1

package/README.md

@@ -72,6 +72,45 @@ 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
+
+`@icebreakers/eslint-config` bundles the Stylelint bridge and uses
+`@icebreakers/stylelint-config` as the default Stylelint preset when you opt in.
+The bridge is still disabled by default. Turn it on with `stylelint: true` to
+lint `*.css`, `*.scss`, and `.vue` style blocks through ESLint:
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: true,
+})
+```
+
+You can also inline Stylelint preset options directly in `eslint.config.ts`:
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: {
+    cwd: process.cwd(),
+    presets: {
+      order: false,
+    },
+    rules: {
+      'color-named': 'never',
+    },
+  },
+})
+```
+
+`stylelint.cwd` changes the resolution root, and the remaining fields follow
+the `@icebreakers/stylelint-config` options (`presets`, `tailwindcssPreset`,
+`ignores`, `extends`, `overrides`, `rules`).
+
 ### NestJS Projects
 
 Enable `nestjs: true` together with the TypeScript preset to apply rules tailored for Nest idioms:

package/README.zh.md

@@ -70,6 +70,48 @@ export default icebreaker({
 - `formatters`：默认启用格式化辅助规则。
 - `test`：放宽 Vitest / Jest 常见规则，例如关闭 `test/prefer-lowercase-title`。
 
+### Stylelint 桥接
+
+`@icebreakers/eslint-config` 已内置 Stylelint bridge，并在启用时默认使用
+`@icebreakers/stylelint-config` 作为 Stylelint 预设；但 bridge 默认仍是关闭的。
+设置 `stylelint: true` 后，会把 Stylelint 诊断桥接到 ESLint，用于：
+
+- `*.css`
+- `*.scss`
+- `.vue` 文件里的 `<style>` 块
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: true,
+})
+```
+
+也可以直接把 Stylelint 预设配置写进 `eslint.config.ts`：
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  vue: true,
+  stylelint: {
+    cwd: process.cwd(),
+    presets: {
+      order: false,
+    },
+    rules: {
+      'color-named': 'never',
+    },
+  },
+})
+```
+
+其中 `stylelint.cwd` 用来指定配置解析根目录，其余字段沿用
+`@icebreakers/stylelint-config` 的选项结构，例如 `presets`、
+`tailwindcssPreset`、`ignores`、`extends`、`overrides`、`rules`。
+
 ### NestJS 项目
 
 建议在 Nest 项目中同时开启 `typescript` 与 `nestjs`，以便应用以下定制：

package/dist/index.cjs

@@ -149,6 +149,9 @@ function getDefaultTypescriptOptions(opts) {
 }
 //#endregion
 //#region src/features.ts
+function resolveStylelintConfigLoader() {
+	return require("url").pathToFileURL(__filename).href.endsWith(".ts") ? new URL("./stylelint.ts", require("url").pathToFileURL(__filename).href).href : new URL("./stylelint.js", require("url").pathToFileURL(__filename).href).href;
+}
 function resolveTailwindPresets(option) {
 	if (!option) return [];
 	if (typeof option === "object") return [(0, antfu_exports.interopDefault)(import("eslint-plugin-better-tailwindcss")).then((eslintPluginBetterTailwindcss) => {
@@ -170,6 +173,42 @@ function resolveTailwindPresets(option) {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
 }
+function resolveStylelintBridgeOptions(option) {
+	const { cwd, ...stylelintConfigOptions } = typeof option === "object" ? option : {};
+	return {
+		...cwd ? { cwd } : {},
+		configLoader: resolveStylelintConfigLoader(),
+		configOptions: stylelintConfigOptions
+	};
+}
+function resolveStylelintBridgePresets(option) {
+	if (!option) return [];
+	const pluginModulePromise = import("eslint-plugin-better-stylelint");
+	const stylelintOptions = resolveStylelintBridgeOptions(option);
+	return [
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.{css,pcss,postcss}"],
+				plugins: { stylelint: pluginModule.default },
+				processor: pluginModule.createStylelintProcessor(stylelintOptions)
+			};
+		}),
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.{scss,sass}"],
+				plugins: { stylelint: pluginModule.default },
+				processor: pluginModule.createStylelintProcessor(stylelintOptions)
+			};
+		}),
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.vue"],
+				plugins: { stylelint: pluginModule.default },
+				rules: { "stylelint/stylelint": ["error", stylelintOptions] }
+			};
+		})
+	];
+}
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
@@ -435,7 +474,7 @@ function getPresets(options, mode) {
 		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
 		rules: { "style/eol-last": "off" }
 	}];
-	presets.push(...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
+	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
@@ -447,6 +486,7 @@ function icebreakerLegacy(options = {}, ...userConfigs) {
 	return (0, antfu_exports.antfu)(...getPresets(options, "legacy"), ...userConfigs);
 }
 //#endregion
+exports.__toESM = __toESM;
 exports.getPresets = getPresets;
 exports.icebreaker = icebreaker;
 exports.icebreakerLegacy = icebreakerLegacy;

package/dist/index.d.cts

@@ -2922,12 +2922,21 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
+interface StylelintBridgeOption {
+  cwd?: string;
+}
+type StylelintBridgeConfig = boolean | StylelintBridgeOption;
 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
@@ -2968,4 +2977,4 @@ declare function icebreakerLegacy(options?: UserDefinedOptions, ...userConfigs:
 //#region src/preset.d.ts
 declare function getPresets(options?: UserDefinedOptions, mode?: 'legacy'): [UserDefinedOptions, ...UserConfigItem[]];
 //#endregion
-export { type ConfigNames, type FlatConfigComposer, type TailwindcssConfig, type TailwindcssOption, type TypedFlatConfigItem, type UserConfigItem, type UserDefinedOptions, getPresets, icebreaker, icebreakerLegacy };
+export { type ConfigNames, type FlatConfigComposer, type StylelintBridgeConfig, type StylelintBridgeOption, type TailwindcssConfig, type TailwindcssOption, type TypedFlatConfigItem, type UserConfigItem, type UserDefinedOptions, getPresets, icebreaker, icebreakerLegacy };

package/dist/index.d.ts

@@ -2922,12 +2922,21 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
+interface StylelintBridgeOption {
+  cwd?: string;
+}
+type StylelintBridgeConfig = boolean | StylelintBridgeOption;
 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
@@ -2968,4 +2977,4 @@ declare function icebreakerLegacy(options?: UserDefinedOptions, ...userConfigs:
 //#region src/preset.d.ts
 declare function getPresets(options?: UserDefinedOptions, mode?: 'legacy'): [UserDefinedOptions, ...UserConfigItem[]];
 //#endregion
-export { type ConfigNames, type FlatConfigComposer, type TailwindcssConfig, type TailwindcssOption, type TypedFlatConfigItem, type UserConfigItem, type UserDefinedOptions, getPresets, icebreaker, icebreakerLegacy };
+export { type ConfigNames, type FlatConfigComposer, type StylelintBridgeConfig, type StylelintBridgeOption, type TailwindcssConfig, type TailwindcssOption, type TypedFlatConfigItem, type UserConfigItem, type UserDefinedOptions, getPresets, icebreaker, icebreakerLegacy };

package/dist/index.js

@@ -140,6 +140,9 @@ function getDefaultTypescriptOptions(opts) {
 }
 //#endregion
 //#region src/features.ts
+function resolveStylelintConfigLoader() {
+	return import.meta.url.endsWith(".ts") ? new URL("./stylelint.ts", import.meta.url).href : new URL("./stylelint.js", import.meta.url).href;
+}
 function resolveTailwindPresets(option) {
 	if (!option) return [];
 	if (typeof option === "object") return [(0, antfu_exports.interopDefault)(import("eslint-plugin-better-tailwindcss")).then((eslintPluginBetterTailwindcss) => {
@@ -161,6 +164,42 @@ function resolveTailwindPresets(option) {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
 }
+function resolveStylelintBridgeOptions(option) {
+	const { cwd, ...stylelintConfigOptions } = typeof option === "object" ? option : {};
+	return {
+		...cwd ? { cwd } : {},
+		configLoader: resolveStylelintConfigLoader(),
+		configOptions: stylelintConfigOptions
+	};
+}
+function resolveStylelintBridgePresets(option) {
+	if (!option) return [];
+	const pluginModulePromise = import("eslint-plugin-better-stylelint");
+	const stylelintOptions = resolveStylelintBridgeOptions(option);
+	return [
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.{css,pcss,postcss}"],
+				plugins: { stylelint: pluginModule.default },
+				processor: pluginModule.createStylelintProcessor(stylelintOptions)
+			};
+		}),
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.{scss,sass}"],
+				plugins: { stylelint: pluginModule.default },
+				processor: pluginModule.createStylelintProcessor(stylelintOptions)
+			};
+		}),
+		pluginModulePromise.then((pluginModule) => {
+			return {
+				files: ["**/*.vue"],
+				plugins: { stylelint: pluginModule.default },
+				rules: { "stylelint/stylelint": ["error", stylelintOptions] }
+			};
+		})
+	];
+}
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
@@ -426,7 +465,7 @@ function getPresets(options, mode) {
 		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
 		rules: { "style/eol-last": "off" }
 	}];
-	presets.push(...resolveTailwindPresets(resolved.tailwindcss), ...resolveMdxPresets(resolved.mdx), ...resolveNestPresets(resolved.nestjs), ...resolveQueryPresets(resolved.query), ...resolveAccessibilityPresets(resolved.a11y, resolved.vue, resolved.react));
+	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/stylelint.cjs

@@ -0,0 +1,9 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("./index.cjs");
+let _icebreakers_stylelint_config = require("@icebreakers/stylelint-config");
+//#region src/stylelint.ts
+function resolveStylelintConfig(options = {}) {
+	return (0, _icebreakers_stylelint_config.createStylelintConfig)(options);
+}
+//#endregion
+exports.resolveStylelintConfig = resolveStylelintConfig;

package/dist/stylelint.d.cts

@@ -0,0 +1,6 @@
+import { IcebreakerStylelintOptions, IcebreakerStylelintOptions as IcebreakerStylelintOptions$1, createStylelintConfig } from "@icebreakers/stylelint-config";
+
+//#region src/stylelint.d.ts
+declare function resolveStylelintConfig(options?: IcebreakerStylelintOptions$1): ReturnType<typeof createStylelintConfig>;
+//#endregion
+export { type IcebreakerStylelintOptions, resolveStylelintConfig };

package/dist/stylelint.d.ts

@@ -0,0 +1,6 @@
+import { IcebreakerStylelintOptions, IcebreakerStylelintOptions as IcebreakerStylelintOptions$1, createStylelintConfig } from "@icebreakers/stylelint-config";
+
+//#region src/stylelint.d.ts
+declare function resolveStylelintConfig(options?: IcebreakerStylelintOptions$1): ReturnType<typeof createStylelintConfig>;
+//#endregion
+export { type IcebreakerStylelintOptions, resolveStylelintConfig };

package/dist/stylelint.js

@@ -0,0 +1,7 @@
+import { createStylelintConfig } from "@icebreakers/stylelint-config";
+//#region src/stylelint.ts
+function resolveStylelintConfig(options = {}) {
+	return createStylelintConfig(options);
+}
+//#endregion
+export { resolveStylelintConfig };

package/index.d.ts

@@ -13,9 +13,14 @@ export interface TailwindcssOption {
 }
 
 export type TailwindcssConfig = boolean | TailwindcssOption
+export interface StylelintBridgeOption {
+  cwd?: string
+}
+export type StylelintBridgeConfig = boolean | StylelintBridgeOption
 
 export type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem & {
   tailwindcss?: TailwindcssConfig
+  stylelint?: StylelintBridgeConfig
   mdx?: boolean
   a11y?: boolean
   nestjs?: boolean

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/eslint-config",
   "type": "module",
-  "version": "1.6.33",
+  "version": "2.0.1",
   "description": "ESLint preset from Icebreaker's dev-configs",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -24,6 +24,11 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./stylelint": {
+      "types": "./dist/stylelint.d.ts",
+      "import": "./dist/stylelint.js",
+      "require": "./dist/stylelint.cjs"
+    },
     "./*": "./*"
   },
   "main": "./dist/index.cjs",
@@ -44,18 +49,20 @@
   "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",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.5.2",
     "eslint-plugin-tailwindcss": "3.18.2",
-    "eslint-plugin-vuejs-accessibility": "^2.5.0"
+    "eslint-plugin-vuejs-accessibility": "^2.5.0",
+    "@icebreakers/stylelint-config": "2.1.0",
+    "eslint-plugin-better-stylelint": "0.1.1"
   },
   "optionalDependencies": {
-    "@unocss/eslint-plugin": "66.6.6",
+    "@unocss/eslint-plugin": "66.6.7",
     "eslint-plugin-mdx": "3.7.0"
   },
   "publishConfig": {
@@ -65,6 +72,8 @@
   "tsd": {
     "directory": "test-d",
     "compilerOptions": {
+      "module": "esnext",
+      "moduleResolution": "bundler",
       "skipLibCheck": true
     }
   },