@icebreakers/eslint-config 2.0.3 → 2.1.1

package/README.md

@@ -10,6 +10,7 @@
 
 - Node.js 18 or newer
 - ESLint 9 with flat config support
+- React and Next related plugins are optional. If they are missing, `react`, `nextjs`, `query`, and React-side `a11y` helpers are skipped automatically instead of failing config resolution.
 - 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`)
 
 ## Installation
@@ -56,21 +57,71 @@ export default icebreaker({
   a11y: true,
   nestjs: true,
   ionic: true,
-  weapp: true,
+  miniProgram: true,
   formatters: true,
 })
 ```
 
-- `vue` – enables Vue + optionally version specific overrides (Vue 2/3) and ionic/weapp adjustments.
-- `react` – defers to the upstream React preset and unlocks accessibility helpers when `a11y` is enabled.
-- `query` – toggles the TanStack Query plugin (`@tanstack/eslint-plugin-query`) and its recommended lint rules.
+- `miniProgram` – injects Mini Program globals, ignores common outputs/config files, and enables Vue-side Mini Program compatibility tweaks when `vue` is on.
+- `vue` – enables Vue + optionally version specific overrides (Vue 2/3) and ionic/miniProgram adjustments.
+- `react` – defers to the upstream React preset and unlocks accessibility helpers when `a11y` is enabled. If the React plugin set is not installed, this flag is ignored automatically.
+- `query` – toggles the TanStack Query plugin (`@tanstack/eslint-plugin-query`) and its recommended lint rules. Missing plugin installs are treated as a no-op.
 - `tailwindcss` – pass `true` to use the built-in Tailwind flat config or provide `{ entryPoint, tailwindConfig }` for Tailwind v4/v3 projects.
 - `mdx` – activates MDX linting via `eslint-plugin-mdx`.
-- `a11y` – wires in JSX (React) and Vue accessibility plugins.
+- `a11y` – wires in JSX (React) and Vue accessibility plugins. Missing framework-specific plugins are skipped independently.
 - `typescript` – extends the TypeScript preset and applies stricter unused diagnostics. Pair with `nestjs` for Nest specific adjustments.
 - `nestjs` – enables NestJS-centric TypeScript tweaks (empty decorated constructors, declaration merging, DI parameter properties, etc.).
 - `formatters` – keeps the built-in formatting rules enabled by default.
 - `test` – relaxes certain Vitest/Jest style rules (`test/prefer-lowercase-title`).
+- `weapp` – legacy alias for `miniProgram`; kept for backward compatibility.
+
+### Mini Program Preset
+
+`miniProgram: true` is the recommended API for `weapp-vite`, `wevu`, and native
+Mini Program templates. It enables the following defaults:
+
+- injects readonly globals for `wx`, `Page`, `App`, `Component`, `getApp`, `getCurrentPages`, `requirePlugin`, and `WechatMiniprogram`
+- ignores `dist/**`, `.weapp-vite/**`, `miniprogram_npm/**`, `node_modules/**`, `project.config.json`, and `project.private.config.json`
+- when `vue: true` is also enabled, relaxes Vue template checks for Mini Program inline tags such as `<text>`
+
+#### Native Mini Program Minimal Config
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+})
+```
+
+#### weapp-vite + wevu Minimal Config
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  vue: true,
+})
+```
+
+#### Combining With Existing Options
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  vue: true,
+  tailwindcss: true,
+  ignores: [
+    'coverage/**',
+  ],
+})
+```
+
+`miniProgram` only adds the platform defaults. User supplied `ignores`,
+`extends`, `rules`, and downstream flat config items still compose normally.
 
 ### Stylelint Bridge
 
@@ -147,6 +198,6 @@ You may also pass other flat configs (e.g. from in-house presets) as additional
 
 ## Troubleshooting
 
-- Missing plugin errors usually mean the optional dependency is not installed in the current workspace. Add it with `pnpm add -D`.
+- Missing plugin errors usually mean a feature is enabled without its optional dependency being installed in the current workspace. React and Next related presets now auto-skip in that case; other features can be added with `pnpm add -D`.
 - When combining legacy `.eslintrc` projects, prefer `icebreakerLegacy()` and move overrides into flat config format incrementally.
 - Tailwind class validation reads from your `tailwind.config.*`; double check the path when using monorepo roots or custom build tooling.

package/README.zh.md

@@ -8,6 +8,7 @@
 
 - Node.js 18 或更高版本
 - 支持 Flat Config 的 ESLint 9
+- React / Next 相关插件现在是可选项。缺失时会自动跳过 `react`、`nextjs`、`query` 以及 React 侧的 `a11y` 配置，而不是在解析配置时直接报错。
 - 如需启用 Tailwind、MDX、UnoCSS 等，可安装对应的可选依赖：`eslint-plugin-tailwindcss` / `eslint-plugin-better-tailwindcss`、`eslint-plugin-mdx`、`@unocss/eslint-plugin`
 
 ## 安装
@@ -54,21 +55,71 @@ export default icebreaker({
   a11y: true,
   nestjs: true,
   ionic: true,
-  weapp: true,
+  miniProgram: true,
   formatters: true,
 })
 ```
 
-- `vue`：启用 Vue 规则，可根据 Vue 2/3 自动切换，并在 `ionic`、`weapp` 选项开启时追加对应覆盖。
-- `react`：复用上游 React 预设，配合 `a11y` 注入无障碍插件。
-- `query`：按需启用 TanStack Query 插件（`@tanstack/eslint-plugin-query`）及其推荐规则。
+- `miniProgram`：启用小程序预设，注入全局变量、忽略常见产物/配置文件，并在 `vue: true` 时补充小程序模板兼容调整。
+- `vue`：启用 Vue 规则，可根据 Vue 2/3 自动切换，并在 `ionic`、`miniProgram` 选项开启时追加对应覆盖。
+- `react`：复用上游 React 预设，配合 `a11y` 注入无障碍插件；如果 React 插件组未安装，会自动忽略该选项。
+- `query`：按需启用 TanStack Query 插件（`@tanstack/eslint-plugin-query`）及其推荐规则；缺少插件时按 no-op 处理。
 - `tailwindcss`：传入 `true` 使用内置 Tailwind flat 配置，或通过对象指定 Tailwind v4 的入口文件 / v3 的配置文件路径。
 - `mdx`：激活 `eslint-plugin-mdx` 处理 `.mdx` 文件。
-- `a11y`：按需引入 JSX 与 Vue 的无障碍规则。
+- `a11y`：按需引入 JSX 与 Vue 的无障碍规则，缺少某一侧插件时只跳过对应框架配置。
 - `typescript`：开启 TypeScript 预设，加强未使用诊断，可与 `nestjs` 搭配使用以获得 Nest 专属优化。
 - `nestjs`：针对 NestJS 场景做 TypeScript 调整（允许带装饰器的空构造函数、依赖注入参数属性、声明合并等）。
 - `formatters`：默认启用格式化辅助规则。
 - `test`：放宽 Vitest / Jest 常见规则，例如关闭 `test/prefer-lowercase-title`。
+- `weapp`：`miniProgram` 的兼容别名，保留但不再推荐作为主入口。
+
+### 小程序预设
+
+推荐在 `weapp-vite`、`wevu`、原生小程序模板里统一使用 `miniProgram: true`。
+它会默认完成：
+
+- 注入 `wx`、`Page`、`App`、`Component`、`getApp`、`getCurrentPages`、`requirePlugin`、`WechatMiniprogram` 全局变量
+- 忽略 `dist/**`、`.weapp-vite/**`、`miniprogram_npm/**`、`node_modules/**`、`project.config.json`、`project.private.config.json`
+- 当同时开启 `vue: true` 时，降低 `<text>` 等小程序内联标签的误报
+
+#### 原生小程序最小配置
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+})
+```
+
+#### weapp-vite + wevu 最小配置
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  vue: true,
+})
+```
+
+#### 与现有选项组合
+
+```ts
+import { icebreaker } from '@icebreakers/eslint-config'
+
+export default icebreaker({
+  miniProgram: true,
+  vue: true,
+  tailwindcss: true,
+  ignores: [
+    'coverage/**',
+  ],
+})
+```
+
+`miniProgram` 只负责追加平台默认项；你自己的 `ignores`、`extends`、`rules`
+以及额外 flat config 仍按原有方式继续组合。
 
 ### Stylelint 桥接
 
@@ -148,6 +199,6 @@ export default icebreaker(
 
 ## 常见问题
 
-- 如果提示缺少插件，说明当前工作区未安装对应可选依赖，可通过 `pnpm add -D` 补齐。
+- 如果提示缺少插件，通常是某个功能已开启但当前工作区未安装对应可选依赖。React / Next 相关预设会自动跳过；其他能力可通过 `pnpm add -D` 补齐。
 - 与旧版 `.eslintrc` 混用时建议先改用 `icebreakerLegacy()`，逐步迁移至 Flat Config。
 - Tailwind 校验依赖 `tailwind.config.*`，Monorepo 或自定义构建路径时请确认配置文件位置。

package/dist/index.cjs

@@ -31,13 +31,14 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-let node_fs = require("node:fs");
-node_fs = __toESM(node_fs);
 let node_module = require("node:module");
 let node_path = require("node:path");
 node_path = __toESM(node_path);
 let node_process = require("node:process");
 node_process = __toESM(node_process);
+let node_url = require("node:url");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
 //#region src/antfu.ts
 var antfu_exports = /* @__PURE__ */ __exportAll({});
 __reExport(antfu_exports, require("@antfu/eslint-config"));
@@ -104,6 +105,9 @@ const nestjsTypeScriptRules = {
 		types: { Function: false }
 	}]
 };
+function isMiniProgramEnabled(opts) {
+	return opts?.miniProgram === true || opts?.weapp === true;
+}
 function getDefaultVueOptions(opts) {
 	const overrides = {
 		"vue/attribute-hyphenation": "off",
@@ -117,7 +121,7 @@ function getDefaultVueOptions(opts) {
 		"vue/no-unused-refs": "warn"
 	};
 	if (opts?.ionic) overrides["vue/no-deprecated-slot-attribute"] = "off";
-	if (opts?.weapp) overrides["vue/singleline-html-element-content-newline"] = ["warn", {
+	if (isMiniProgramEnabled(opts)) overrides["vue/singleline-html-element-content-newline"] = ["warn", {
 		ignoreWhenNoAttributes: true,
 		ignoreWhenEmpty: true,
 		ignores: ["text", ...INLINE_ELEMENTS],
@@ -148,27 +152,56 @@ function getDefaultTypescriptOptions(opts) {
 	return { overrides };
 }
 //#endregion
+//#region src/utils.ts
+const require$2 = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href);
+const PACKAGE_DIR = node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
+function isObject(o) {
+	return Object.prototype.toString.call(o) === "[object Object]";
+}
+function isPackageAvailable$1(name, searchPaths = [node_process.default.cwd(), PACKAGE_DIR]) {
+	try {
+		require$2.resolve(name, { paths: searchPaths });
+		return true;
+	} catch {
+		return false;
+	}
+}
+function hasAllPackages(names, searchPaths) {
+	return names.every((name) => isPackageAvailable$1(name, searchPaths));
+}
+//#endregion
 //#region src/features.ts
+const BETTER_TAILWIND_PACKAGES = ["eslint-plugin-better-tailwindcss"];
+const TAILWIND_PACKAGES = ["eslint-plugin-tailwindcss"];
+const STYLELINT_BRIDGE_PACKAGES = ["eslint-plugin-better-stylelint"];
+const MDX_PACKAGES = ["eslint-plugin-mdx"];
+const VUE_A11Y_PACKAGES = ["eslint-plugin-vuejs-accessibility"];
+const REACT_A11Y_PACKAGES = ["eslint-plugin-jsx-a11y"];
+const QUERY_PACKAGES = ["@tanstack/eslint-plugin-query"];
 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) => {
-		const betterTailwindcssRules = {
-			...eslintPluginBetterTailwindcss.configs["recommended-warn"].rules,
-			...eslintPluginBetterTailwindcss.configs["recommended-error"].rules
-		};
-		return {
-			name: "icebreaker/better-tailwindcss",
-			plugins: { "better-tailwindcss": eslintPluginBetterTailwindcss },
-			rules: betterTailwindcssRules,
-			settings: { "better-tailwindcss": {
-				entryPoint: option.entryPoint,
-				tailwindConfig: option.tailwindConfig
-			} }
-		};
-	})];
+	if (typeof option === "object") {
+		if (!hasAllPackages(BETTER_TAILWIND_PACKAGES)) return [];
+		return [(0, antfu_exports.interopDefault)(import("eslint-plugin-better-tailwindcss")).then((eslintPluginBetterTailwindcss) => {
+			const betterTailwindcssRules = {
+				...eslintPluginBetterTailwindcss.configs["recommended-warn"].rules,
+				...eslintPluginBetterTailwindcss.configs["recommended-error"].rules
+			};
+			return {
+				name: "icebreaker/better-tailwindcss",
+				plugins: { "better-tailwindcss": eslintPluginBetterTailwindcss },
+				rules: betterTailwindcssRules,
+				settings: { "better-tailwindcss": {
+					entryPoint: option.entryPoint,
+					tailwindConfig: option.tailwindConfig
+				} }
+			};
+		})];
+	}
+	if (!hasAllPackages(TAILWIND_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-tailwindcss")).then((tailwind) => {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
@@ -183,6 +216,7 @@ function resolveStylelintBridgeOptions(option) {
 }
 function resolveStylelintBridgePresets(option) {
 	if (!option) return [];
+	if (!hasAllPackages(STYLELINT_BRIDGE_PACKAGES)) return [];
 	const pluginModulePromise = import("eslint-plugin-better-stylelint");
 	const stylelintOptions = resolveStylelintBridgeOptions(option);
 	return [
@@ -211,6 +245,7 @@ function resolveStylelintBridgePresets(option) {
 }
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
+	if (!hasAllPackages(MDX_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
 		return [{
 			...mdx.flat,
@@ -227,10 +262,10 @@ function resolveMdxPresets(isEnabled) {
 function resolveAccessibilityPresets(isEnabled, vueOption, reactOption) {
 	if (!isEnabled) return [];
 	const presets = [];
-	if (vueOption) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-vuejs-accessibility")).then((pluginVueA11y) => {
+	if (vueOption && hasAllPackages(VUE_A11Y_PACKAGES)) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-vuejs-accessibility")).then((pluginVueA11y) => {
 		return pluginVueA11y.configs["flat/recommended"];
 	}));
-	if (reactOption) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-jsx-a11y")).then((jsxA11y) => {
+	if (reactOption && hasAllPackages(REACT_A11Y_PACKAGES)) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-jsx-a11y")).then((jsxA11y) => {
 		return jsxA11y.flatConfigs.recommended;
 	}));
 	return presets;
@@ -244,6 +279,7 @@ function resolveNestPresets(isEnabled) {
 }
 function resolveQueryPresets(isEnabled) {
 	if (!isEnabled) return [];
+	if (!hasAllPackages(QUERY_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("@tanstack/eslint-plugin-query")).then((pluginQuery) => pluginQuery.configs["flat/recommended"])];
 }
 //#endregion
@@ -287,11 +323,6 @@ createDefu((object, key, currentValue) => {
 	}
 });
 //#endregion
-//#region src/utils.ts
-function isObject(o) {
-	return Object.prototype.toString.call(o) === "[object Object]";
-}
-//#endregion
 //#region src/options.ts
 const BASE_DEFAULTS = {
 	formatters: true,
@@ -450,6 +481,10 @@ function resolveFormattersOption(input, cwd = node_process.default.cwd()) {
 }
 function resolveUserOptions(options) {
 	const resolved = defu({}, options ?? {}, BASE_DEFAULTS);
+	if (isMiniProgramEnabled(options)) {
+		resolved.miniProgram = true;
+		delete resolved.weapp;
+	}
 	const resolvedVue = mergeOptionWithDefaults(resolved.vue, getDefaultVueOptions(options), { postProcess: applyVueVersionSpecificRules });
 	if (resolvedVue === void 0) delete resolved.vue;
 	else resolved.vue = resolvedVue;
@@ -468,22 +503,63 @@ function createBaseRuleSet(isLegacy) {
 }
 //#endregion
 //#region src/preset.ts
+const MINI_PROGRAM_IGNORES = [
+	"dist/**",
+	".weapp-vite/**",
+	"miniprogram_npm/**",
+	"node_modules/**",
+	"project.config.json",
+	"project.private.config.json"
+];
+const MINI_PROGRAM_GLOBALS = {
+	wx: "readonly",
+	Page: "readonly",
+	App: "readonly",
+	Component: "readonly",
+	getApp: "readonly",
+	getCurrentPages: "readonly",
+	requirePlugin: "readonly",
+	WechatMiniprogram: "readonly"
+};
 function getPresets(options, mode) {
 	const resolved = resolveUserOptions(options);
-	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }, {
-		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
-		rules: { "style/eol-last": "off" }
-	}];
+	const presets = [
+		...resolved.miniProgram ? [{ ignores: [...MINI_PROGRAM_IGNORES] }, {
+			files: ["**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx,vue}"],
+			languageOptions: { globals: MINI_PROGRAM_GLOBALS }
+		}] : [],
+		{ 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
 //#region src/factory.ts
+const OPTIONAL_ANTFU_FEATURE_PACKAGES = {
+	react: [
+		"@eslint-react/eslint-plugin",
+		"eslint-plugin-react-hooks",
+		"eslint-plugin-react-refresh"
+	],
+	nextjs: ["@next/eslint-plugin-next"]
+};
+function normalizeOptionalAntfuFeatures(options) {
+	const normalized = { ...options };
+	if (normalized.react && !hasAllPackages([...OPTIONAL_ANTFU_FEATURE_PACKAGES.react])) normalized.react = false;
+	if (normalized.nextjs && !hasAllPackages([...OPTIONAL_ANTFU_FEATURE_PACKAGES.nextjs])) normalized.nextjs = false;
+	return normalized;
+}
 function icebreaker(options = {}, ...userConfigs) {
-	return (0, antfu_exports.antfu)(...getPresets(options), ...userConfigs);
+	const [resolved, ...presets] = getPresets(options);
+	return (0, antfu_exports.antfu)(normalizeOptionalAntfuFeatures(resolved), ...presets, ...userConfigs);
 }
 function icebreakerLegacy(options = {}, ...userConfigs) {
-	return (0, antfu_exports.antfu)(...getPresets(options, "legacy"), ...userConfigs);
+	const [resolved, ...presets] = getPresets(options, "legacy");
+	return (0, antfu_exports.antfu)(normalizeOptionalAntfuFeatures(resolved), ...presets, ...userConfigs);
 }
 //#endregion
 exports.__toESM = __toESM;

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 import { Awaitable, ConfigNames, OptionsConfig, TypedFlatConfigItem, TypedFlatConfigItem as TypedFlatConfigItem$1 } from "@antfu/eslint-config";
+import { IcebreakerStylelintOptions } from "@icebreakers/stylelint-config";
 
 //#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
 // ==================================================================================================
@@ -2956,11 +2957,16 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
-interface StylelintBridgeOption {
+interface StylelintBridgeOption extends IcebreakerStylelintOptions {
   cwd?: string;
 }
 type StylelintBridgeConfig = boolean | StylelintBridgeOption;
 type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
+  /**
+   * Enable Mini Program support.
+   * @default false
+   */
+  miniProgram?: boolean;
   /**
    * Enable TailwindCSS support
    * @default false
@@ -2998,6 +3004,7 @@ type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
   ionic?: boolean;
   /**
    * Enable Weapp support
+   * @deprecated Use `miniProgram` instead.
    * @default false
    */
   weapp?: boolean;

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { Awaitable, ConfigNames, OptionsConfig, TypedFlatConfigItem, TypedFlatConfigItem as TypedFlatConfigItem$1 } from "@antfu/eslint-config";
+import { IcebreakerStylelintOptions } from "@icebreakers/stylelint-config";
 
 //#region ../../node_modules/.pnpm/@types+json-schema@7.0.15/node_modules/@types/json-schema/index.d.ts
 // ==================================================================================================
@@ -2956,11 +2957,16 @@ interface TailwindcssOption {
   tailwindConfig?: string;
 }
 type TailwindcssConfig = boolean | TailwindcssOption;
-interface StylelintBridgeOption {
+interface StylelintBridgeOption extends IcebreakerStylelintOptions {
   cwd?: string;
 }
 type StylelintBridgeConfig = boolean | StylelintBridgeOption;
 type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
+  /**
+   * Enable Mini Program support.
+   * @default false
+   */
+  miniProgram?: boolean;
   /**
    * Enable TailwindCSS support
    * @default false
@@ -2998,6 +3004,7 @@ type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem$1 & {
   ionic?: boolean;
   /**
    * Enable Weapp support
+   * @deprecated Use `miniProgram` instead.
    * @default false
    */
   weapp?: boolean;

package/dist/index.js

@@ -1,7 +1,8 @@
 import { createRequire } from "node:module";
-import fs from "node:fs";
 import path from "node:path";
 import process from "node:process";
+import { fileURLToPath } from "node:url";
+import fs from "node:fs";
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -95,6 +96,9 @@ const nestjsTypeScriptRules = {
 		types: { Function: false }
 	}]
 };
+function isMiniProgramEnabled(opts) {
+	return opts?.miniProgram === true || opts?.weapp === true;
+}
 function getDefaultVueOptions(opts) {
 	const overrides = {
 		"vue/attribute-hyphenation": "off",
@@ -108,7 +112,7 @@ function getDefaultVueOptions(opts) {
 		"vue/no-unused-refs": "warn"
 	};
 	if (opts?.ionic) overrides["vue/no-deprecated-slot-attribute"] = "off";
-	if (opts?.weapp) overrides["vue/singleline-html-element-content-newline"] = ["warn", {
+	if (isMiniProgramEnabled(opts)) overrides["vue/singleline-html-element-content-newline"] = ["warn", {
 		ignoreWhenNoAttributes: true,
 		ignoreWhenEmpty: true,
 		ignores: ["text", ...INLINE_ELEMENTS],
@@ -139,27 +143,56 @@ function getDefaultTypescriptOptions(opts) {
 	return { overrides };
 }
 //#endregion
+//#region src/utils.ts
+const require$1 = createRequire(import.meta.url);
+const PACKAGE_DIR = path.dirname(fileURLToPath(import.meta.url));
+function isObject(o) {
+	return Object.prototype.toString.call(o) === "[object Object]";
+}
+function isPackageAvailable$1(name, searchPaths = [process.cwd(), PACKAGE_DIR]) {
+	try {
+		require$1.resolve(name, { paths: searchPaths });
+		return true;
+	} catch {
+		return false;
+	}
+}
+function hasAllPackages(names, searchPaths) {
+	return names.every((name) => isPackageAvailable$1(name, searchPaths));
+}
+//#endregion
 //#region src/features.ts
+const BETTER_TAILWIND_PACKAGES = ["eslint-plugin-better-tailwindcss"];
+const TAILWIND_PACKAGES = ["eslint-plugin-tailwindcss"];
+const STYLELINT_BRIDGE_PACKAGES = ["eslint-plugin-better-stylelint"];
+const MDX_PACKAGES = ["eslint-plugin-mdx"];
+const VUE_A11Y_PACKAGES = ["eslint-plugin-vuejs-accessibility"];
+const REACT_A11Y_PACKAGES = ["eslint-plugin-jsx-a11y"];
+const QUERY_PACKAGES = ["@tanstack/eslint-plugin-query"];
 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) => {
-		const betterTailwindcssRules = {
-			...eslintPluginBetterTailwindcss.configs["recommended-warn"].rules,
-			...eslintPluginBetterTailwindcss.configs["recommended-error"].rules
-		};
-		return {
-			name: "icebreaker/better-tailwindcss",
-			plugins: { "better-tailwindcss": eslintPluginBetterTailwindcss },
-			rules: betterTailwindcssRules,
-			settings: { "better-tailwindcss": {
-				entryPoint: option.entryPoint,
-				tailwindConfig: option.tailwindConfig
-			} }
-		};
-	})];
+	if (typeof option === "object") {
+		if (!hasAllPackages(BETTER_TAILWIND_PACKAGES)) return [];
+		return [(0, antfu_exports.interopDefault)(import("eslint-plugin-better-tailwindcss")).then((eslintPluginBetterTailwindcss) => {
+			const betterTailwindcssRules = {
+				...eslintPluginBetterTailwindcss.configs["recommended-warn"].rules,
+				...eslintPluginBetterTailwindcss.configs["recommended-error"].rules
+			};
+			return {
+				name: "icebreaker/better-tailwindcss",
+				plugins: { "better-tailwindcss": eslintPluginBetterTailwindcss },
+				rules: betterTailwindcssRules,
+				settings: { "better-tailwindcss": {
+					entryPoint: option.entryPoint,
+					tailwindConfig: option.tailwindConfig
+				} }
+			};
+		})];
+	}
+	if (!hasAllPackages(TAILWIND_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-tailwindcss")).then((tailwind) => {
 		return tailwind.configs["flat/recommended"];
 	}), { rules: { "tailwindcss/no-custom-classname": "off" } }];
@@ -174,6 +207,7 @@ function resolveStylelintBridgeOptions(option) {
 }
 function resolveStylelintBridgePresets(option) {
 	if (!option) return [];
+	if (!hasAllPackages(STYLELINT_BRIDGE_PACKAGES)) return [];
 	const pluginModulePromise = import("eslint-plugin-better-stylelint");
 	const stylelintOptions = resolveStylelintBridgeOptions(option);
 	return [
@@ -202,6 +236,7 @@ function resolveStylelintBridgePresets(option) {
 }
 function resolveMdxPresets(isEnabled) {
 	if (!isEnabled) return [];
+	if (!hasAllPackages(MDX_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("eslint-plugin-mdx")).then((mdx) => {
 		return [{
 			...mdx.flat,
@@ -218,10 +253,10 @@ function resolveMdxPresets(isEnabled) {
 function resolveAccessibilityPresets(isEnabled, vueOption, reactOption) {
 	if (!isEnabled) return [];
 	const presets = [];
-	if (vueOption) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-vuejs-accessibility")).then((pluginVueA11y) => {
+	if (vueOption && hasAllPackages(VUE_A11Y_PACKAGES)) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-vuejs-accessibility")).then((pluginVueA11y) => {
 		return pluginVueA11y.configs["flat/recommended"];
 	}));
-	if (reactOption) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-jsx-a11y")).then((jsxA11y) => {
+	if (reactOption && hasAllPackages(REACT_A11Y_PACKAGES)) presets.push((0, antfu_exports.interopDefault)(import("eslint-plugin-jsx-a11y")).then((jsxA11y) => {
 		return jsxA11y.flatConfigs.recommended;
 	}));
 	return presets;
@@ -235,6 +270,7 @@ function resolveNestPresets(isEnabled) {
 }
 function resolveQueryPresets(isEnabled) {
 	if (!isEnabled) return [];
+	if (!hasAllPackages(QUERY_PACKAGES)) return [];
 	return [(0, antfu_exports.interopDefault)(import("@tanstack/eslint-plugin-query")).then((pluginQuery) => pluginQuery.configs["flat/recommended"])];
 }
 //#endregion
@@ -278,11 +314,6 @@ createDefu((object, key, currentValue) => {
 	}
 });
 //#endregion
-//#region src/utils.ts
-function isObject(o) {
-	return Object.prototype.toString.call(o) === "[object Object]";
-}
-//#endregion
 //#region src/options.ts
 const BASE_DEFAULTS = {
 	formatters: true,
@@ -441,6 +472,10 @@ function resolveFormattersOption(input, cwd = process.cwd()) {
 }
 function resolveUserOptions(options) {
 	const resolved = defu({}, options ?? {}, BASE_DEFAULTS);
+	if (isMiniProgramEnabled(options)) {
+		resolved.miniProgram = true;
+		delete resolved.weapp;
+	}
 	const resolvedVue = mergeOptionWithDefaults(resolved.vue, getDefaultVueOptions(options), { postProcess: applyVueVersionSpecificRules });
 	if (resolvedVue === void 0) delete resolved.vue;
 	else resolved.vue = resolvedVue;
@@ -459,22 +494,63 @@ function createBaseRuleSet(isLegacy) {
 }
 //#endregion
 //#region src/preset.ts
+const MINI_PROGRAM_IGNORES = [
+	"dist/**",
+	".weapp-vite/**",
+	"miniprogram_npm/**",
+	"node_modules/**",
+	"project.config.json",
+	"project.private.config.json"
+];
+const MINI_PROGRAM_GLOBALS = {
+	wx: "readonly",
+	Page: "readonly",
+	App: "readonly",
+	Component: "readonly",
+	getApp: "readonly",
+	getCurrentPages: "readonly",
+	requirePlugin: "readonly",
+	WechatMiniprogram: "readonly"
+};
 function getPresets(options, mode) {
 	const resolved = resolveUserOptions(options);
-	const presets = [{ rules: createBaseRuleSet(mode === "legacy") }, {
-		files: ["**/*.{css,scss,sass,less,pcss,postcss,json,jsonc,json5}"],
-		rules: { "style/eol-last": "off" }
-	}];
+	const presets = [
+		...resolved.miniProgram ? [{ ignores: [...MINI_PROGRAM_IGNORES] }, {
+			files: ["**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx,vue}"],
+			languageOptions: { globals: MINI_PROGRAM_GLOBALS }
+		}] : [],
+		{ 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
 //#region src/factory.ts
+const OPTIONAL_ANTFU_FEATURE_PACKAGES = {
+	react: [
+		"@eslint-react/eslint-plugin",
+		"eslint-plugin-react-hooks",
+		"eslint-plugin-react-refresh"
+	],
+	nextjs: ["@next/eslint-plugin-next"]
+};
+function normalizeOptionalAntfuFeatures(options) {
+	const normalized = { ...options };
+	if (normalized.react && !hasAllPackages([...OPTIONAL_ANTFU_FEATURE_PACKAGES.react])) normalized.react = false;
+	if (normalized.nextjs && !hasAllPackages([...OPTIONAL_ANTFU_FEATURE_PACKAGES.nextjs])) normalized.nextjs = false;
+	return normalized;
+}
 function icebreaker(options = {}, ...userConfigs) {
-	return (0, antfu_exports.antfu)(...getPresets(options), ...userConfigs);
+	const [resolved, ...presets] = getPresets(options);
+	return (0, antfu_exports.antfu)(normalizeOptionalAntfuFeatures(resolved), ...presets, ...userConfigs);
 }
 function icebreakerLegacy(options = {}, ...userConfigs) {
-	return (0, antfu_exports.antfu)(...getPresets(options, "legacy"), ...userConfigs);
+	const [resolved, ...presets] = getPresets(options, "legacy");
+	return (0, antfu_exports.antfu)(normalizeOptionalAntfuFeatures(resolved), ...presets, ...userConfigs);
 }
 //#endregion
 export { getPresets, icebreaker, icebreakerLegacy };

package/index.d.ts

@@ -4,6 +4,7 @@ import type {
   OptionsConfig,
   TypedFlatConfigItem,
 } from '@antfu/eslint-config'
+import type { IcebreakerStylelintOptions } from '@icebreakers/stylelint-config'
 import type { Linter } from 'eslint'
 import type { FlatConfigComposer } from 'eslint-flat-config-utils'
 
@@ -13,12 +14,13 @@ export interface TailwindcssOption {
 }
 
 export type TailwindcssConfig = boolean | TailwindcssOption
-export interface StylelintBridgeOption {
+export interface StylelintBridgeOption extends IcebreakerStylelintOptions {
   cwd?: string
 }
 export type StylelintBridgeConfig = boolean | StylelintBridgeOption
 
 export type UserDefinedOptions = OptionsConfig & TypedFlatConfigItem & {
+  miniProgram?: boolean
   tailwindcss?: TailwindcssConfig
   stylelint?: StylelintBridgeConfig
   mdx?: boolean

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@icebreakers/eslint-config",
   "type": "module",
-  "version": "2.0.3",
+  "version": "2.1.1",
   "description": "ESLint preset from Icebreaker's dev-configs",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -48,22 +48,22 @@
   },
   "dependencies": {
     "@antfu/eslint-config": "7.7.3",
-    "@eslint-react/eslint-plugin": "^3.0.0",
-    "@next/eslint-plugin-next": "^16.2.1",
-    "@tanstack/eslint-plugin-query": "^5.95.2",
     "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",
-    "@icebreakers/stylelint-config": "2.1.2",
+    "@icebreakers/stylelint-config": "2.2.1",
     "eslint-plugin-better-stylelint": "0.1.1"
   },
   "optionalDependencies": {
+    "@eslint-react/eslint-plugin": "^3.0.0",
+    "@next/eslint-plugin-next": "^16.2.1",
+    "@tanstack/eslint-plugin-query": "^5.95.2",
     "@unocss/eslint-plugin": "66.6.7",
-    "eslint-plugin-mdx": "3.7.0"
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-mdx": "3.7.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.5.2"
   },
   "publishConfig": {
     "access": "public",
@@ -72,8 +72,16 @@
   "tsd": {
     "directory": "test-d",
     "compilerOptions": {
-      "module": "esnext",
-      "moduleResolution": "bundler",
+      "module": "nodenext",
+      "baseUrl": ".",
+      "paths": {
+        "@icebreakers/stylelint-config": [
+          "../stylelint/dist/index.d.ts"
+        ],
+        "eslint-plugin-better-stylelint": [
+          "../eslint-plugin-better-stylelint/dist/index.d.ts"
+        ]
+      },
       "skipLibCheck": true
     }
   },