@infra-x/create-eslint-config 0.1.0

package/dist/index.mjs

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import { access, cp, readdir } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { confirm, intro, log, outro } from "@clack/prompts";
+
+//#region src/index.ts
+async function getConflicts(templateDir$1, destDir$1) {
+	const entries = await readdir(templateDir$1, {
+		recursive: true,
+		withFileTypes: true
+	});
+	const conflicts$1 = [];
+	for (const entry of entries) {
+		if (!entry.isFile()) continue;
+		const rel = path.join(entry.parentPath, entry.name).slice(templateDir$1.length + 1);
+		const destPath = path.join(destDir$1, rel);
+		try {
+			await access(destPath);
+			conflicts$1.push(rel);
+		} catch {}
+	}
+	return conflicts$1;
+}
+intro("@infra-x/create-eslint-config");
+const templateDir = path.join(fileURLToPath(new URL(".", import.meta.url)), "template");
+const destDir = path.join(process.cwd(), "eslint-config");
+const conflicts = await getConflicts(templateDir, destDir);
+if (conflicts.length > 0) {
+	log.warn(`以下文件已存在：\n${conflicts.map((f) => `  ${f}`).join("\n")}`);
+	if (!await confirm({ message: "是否覆盖这些文件？" })) {
+		outro("已取消");
+		process.exit(0);
+	}
+}
+await cp(templateDir, destDir, { recursive: true });
+outro("复制完成！");
+
+//#endregion
+export {  };

package/dist/template/README.md

@@ -0,0 +1,56 @@
+# @workspace/eslint-config
+
+统一基础设施配置工具 - 集成 ESLint、Prettier、TypeScript、EditorConfig
+
+## 安装
+
+```bash
+pnpm add -D @workspace/eslint-config eslint prettier typescript
+```
+
+## 使用
+
+```typescript
+// eslint.config.mts
+import { composeConfig } from '@workspace/eslint-config'
+
+export default composeConfig({
+  typescript: { tsconfigRootDir: import.meta.dirname },
+  react: true,
+  imports: { typescript: true },
+  prettier: true,
+})
+```
+
+## 配置项
+
+### 默认开启
+
+- `ignores` - 忽略文件配置
+- `javascript` - JavaScript 基础规则
+- `typescript` - TypeScript 规则
+- `stylistic` - 代码风格规则
+- `unicorn` - 最佳实践
+- `depend` - 依赖优化建议
+
+### 可选配置
+
+- `react` - React 规则
+- `nextjs` - Next.js 规则
+- `imports` - Import 排序和规则
+- `prettier` - Prettier 格式化
+- `a11y` - 无障碍访问规则
+- `jsdoc` - JSDoc 文档规则
+- `boundaries` - 模块边界规则
+- `packageJson` - package.json 规则
+- `vitest` - Vitest 测试规则
+- `storybook` - Storybook 规则
+
+每个配置项支持：
+- `true` - 使用默认配置
+- `{ ...options }` - 自定义配置
+- `false` - 禁用（仅限默认开启的配置）
+
+## License
+
+PROPRIETARY

package/dist/template/eslint.config.mts

@@ -0,0 +1,15 @@
+import { composeConfig } from './src/index'
+
+import type { Linter } from 'eslint'
+
+const config: Linter.Config[] = composeConfig({
+  typescript: { tsconfigRootDir: import.meta.dirname },
+  imports: {
+    typescript: true,
+    overrides: {
+      // 本包内部使用相对导入，因为没有配置路径别名
+      'no-restricted-imports': 'off',
+    },
+  },
+})
+export default config

package/dist/template/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@workspace/eslint-config",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "A shared ESLint config for infra-x projects.",
+  "author": "infra-x",
+  "license": "MIT",
+  "exports": {
+    ".": "./src/index.ts",
+    "./package.json": "./package.json"
+  },
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/eslint-plugin-jsx-a11y": "^6.10.1",
+    "@types/node": "^25.0.3",
+    "eslint": "^9.39.2",
+    "globals": "16.5.0",
+    "jiti": "2.6.1",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "dependencies": {
+    "@eslint-react/eslint-plugin": "^2.11.0",
+    "@eslint/compat": "1.4.1",
+    "@eslint/core": "0.17.0",
+    "@eslint/js": "^9.39.2",
+    "@next/eslint-plugin-next": "^16.1.6",
+    "@stylistic/eslint-plugin": "^5.7.1",
+    "@vitest/eslint-plugin": "^1.6.6",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-better-tailwindcss": "^4.1.1",
+    "eslint-plugin-boundaries": "^5.4.0",
+    "eslint-plugin-depend": "^1.4.0",
+    "eslint-plugin-import-x": "4.16.1",
+    "eslint-plugin-jsdoc": "^61.7.1",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-package-json": "^0.64.0",
+    "eslint-plugin-prettier": "^5.5.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.26",
+    "eslint-plugin-storybook": "^10.2.7",
+    "eslint-plugin-unicorn": "^57.0.0",
+    "typescript-eslint": "^8.54.0"
+  },
+  "peerDependencies": {
+    "eslint": "^9.39.2",
+    "globals": "16.5.0",
+    "jiti": "2.6.1",
+    "prettier": "^3.7.4",
+    "typescript": "^5.9.3"
+  }
+}

package/dist/template/src/configs/a11y.ts

@@ -0,0 +1,26 @@
+/**
+ * eslint-plugin-jsx-a11y 配置,用于检测 JSX 中的无障碍问题(WCAG 标准)
+ */
+import { defineConfig } from 'eslint/config'
+import jsxA11y from 'eslint-plugin-jsx-a11y'
+
+import { GLOB_JSX } from '../utils'
+
+import type { A11yOptions } from '../types'
+import type { Linter } from 'eslint'
+
+/**
+ * 可访问性规则配置
+ */
+export function a11y(options: A11yOptions = {}): Linter.Config[] {
+  const { files = [GLOB_JSX], overrides = {} } = options
+
+  return defineConfig({
+    name: 'a11y/rules',
+    files,
+    extends: [jsxA11y.flatConfigs.recommended],
+    rules: {
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/boundaries.ts

@@ -0,0 +1,43 @@
+/**
+ * eslint-plugin-boundaries 配置，用于强制执行架构边界规则
+ */
+import { defineConfig } from 'eslint/config'
+import boundariesPlugin from 'eslint-plugin-boundaries'
+
+import { GLOB_SRC } from '../utils'
+
+import type { BoundariesOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function boundaries(options: BoundariesOptions = {}): Linter.Config[] {
+  const { elements, rules, files = [GLOB_SRC], overrides = {} } = options
+
+  if (!elements?.length || !rules?.length) return []
+
+  return defineConfig([
+    {
+      name: 'boundaries/rules',
+      files,
+      plugins: {
+        boundaries: boundariesPlugin,
+      },
+      settings: {
+        'boundaries/elements': elements,
+      },
+      rules: {
+        'boundaries/element-types': [
+          'error',
+          {
+            default: 'disallow',
+            rules: rules.map((rule) => ({
+              from: Array.isArray(rule.from) ? rule.from : [rule.from],
+              allow: rule.allow,
+              message: rule.message,
+            })),
+          },
+        ],
+        ...overrides,
+      },
+    },
+  ])
+}

package/dist/template/src/configs/depend.ts

@@ -0,0 +1,37 @@
+/**
+ * 依赖优化规则配置,检测可用原生 API 替代的包和微型工具库
+ */
+import { fixupPluginRules } from '@eslint/compat'
+import dependPlugin from 'eslint-plugin-depend'
+
+import { GLOB_SRC } from '../utils'
+
+import type { DependOptions } from '../types'
+import type { ESLint, Linter } from 'eslint'
+
+const DEFAULT_PRESETS: DependOptions['presets'] = ['native', 'microutilities', 'preferred']
+
+export function depend(options: DependOptions = {}): Linter.Config[] {
+  const { presets = DEFAULT_PRESETS, modules = [], allowed = [], overrides = {} } = options
+
+  return [
+    {
+      name: 'depend/rules',
+      files: [GLOB_SRC],
+      plugins: {
+        depend: fixupPluginRules(dependPlugin as unknown as ESLint.Plugin),
+      },
+      rules: {
+        'depend/ban-dependencies': [
+          'error',
+          {
+            presets,
+            modules,
+            allowed,
+          },
+        ],
+        ...overrides,
+      },
+    },
+  ]
+}

package/dist/template/src/configs/ignores.ts

@@ -0,0 +1,78 @@
+/**
+ * ESLint 忽略文件配置,支持默认忽略规则和 .gitignore 导入
+ */
+import { existsSync } from 'node:fs'
+import path from 'node:path'
+
+import { includeIgnoreFile } from '@eslint/compat'
+
+import type { IgnoresOptions } from '../types'
+import type { Linter } from 'eslint'
+
+/**
+ * 默认忽略的文件和目录
+ */
+export const DEFAULT_IGNORES: string[] = [
+  // 依赖目录
+  '**/node_modules/**',
+  '**/.pnp.*',
+
+  // 构建产物
+  '**/dist/**',
+  '**/build/**',
+  '**/out/**',
+  '**/.next/**',
+
+  // 缓存目录
+  '**/.cache/**',
+  '**/.turbo/**',
+  '**/.eslintcache',
+
+  // 版本控制
+  '**/.git/**',
+  '**/.svn/**',
+  '**/.hg/**',
+  '**/public/**',
+
+  // 类型文件
+  '**/*.d.ts',
+]
+
+export function ignores(options: IgnoresOptions = {}): Linter.Config[] {
+  const { ignores: userIgnores, gitignore: gitignorePath } = options
+  const configs: Linter.Config[] = []
+
+  if (gitignorePath !== false) {
+    try {
+      const gitignoreFile
+        = typeof gitignorePath === 'string'
+          ? path.resolve(gitignorePath)
+          : path.resolve(process.cwd(), '.gitignore')
+
+      if (existsSync(gitignoreFile)) {
+        configs.push(includeIgnoreFile(gitignoreFile))
+      }
+    } catch {
+      //
+    }
+  }
+
+  const finalIgnores
+    = userIgnores === false
+      ? []
+      : (userIgnores
+          ? [...DEFAULT_IGNORES, ...userIgnores]
+          : DEFAULT_IGNORES)
+
+  if (finalIgnores.length > 0) {
+    configs.push({
+      name: 'defaults',
+      ignores: finalIgnores,
+    })
+  }
+
+  return configs.map((config) => ({
+    ...config,
+    name: `ignores/globals/${config.name}`,
+  }))
+}

package/dist/template/src/configs/imports.ts

@@ -0,0 +1,91 @@
+/**
+ * Import 模块导入规则配置,提供导入排序、循环依赖检测和 TypeScript 支持
+ */
+import { defineConfig } from 'eslint/config'
+import { importX } from 'eslint-plugin-import-x'
+
+import { GLOB_SRC } from '../utils'
+
+import type { ImportsOptions } from '../types'
+import type { ESLint, Linter } from 'eslint'
+
+export function imports(options: ImportsOptions = {}): Linter.Config[] {
+  const { overrides = {}, stylistic = true, typescript = false, noRelativeParentImports = false } = options
+
+  const files = [GLOB_SRC]
+
+  const settingsForTypescript = typescript
+    ? {
+        ...importX.configs['flat/recommended'].settings,
+        'import-x/resolver': { typescript: { alwaysTryTypes: true } },
+      }
+    : {}
+
+  const rulesForTypescript = typescript
+    ? {
+        ...importX.configs['flat/typescript'].rules,
+        'import-x/named': 'off',
+        'import-x/namespace': 'off',
+        'import-x/default': 'off',
+        'import-x/no-named-as-default-member': 'off',
+        'import-x/no-unresolved': 'off',
+      }
+    : {}
+
+  const rulesForStylistic: Record<string, Linter.RuleEntry> = stylistic
+    ? {
+        'import-x/newline-after-import': ['error', { count: 1 }],
+        'import-x/order': [
+          'error',
+          {
+            'groups': [
+              'builtin',
+              'external',
+              'internal',
+              ['parent', 'sibling'],
+              'index',
+              'type',
+            ],
+            'newlines-between': 'always',
+            'alphabetize': {
+              order: 'asc',
+              caseInsensitive: true,
+            },
+            'pathGroups': [
+              {
+                pattern: '@/**',
+                group: 'internal',
+                position: 'before',
+              },
+            ],
+            'pathGroupsExcludedImportTypes': ['type'],
+            'distinctGroup': true,
+          },
+        ],
+      }
+    : {}
+
+  return defineConfig([
+    {
+      name: 'imports/rules',
+      files,
+      plugins: {
+        'import-x': importX as unknown as ESLint.Plugin,
+      },
+      settings: settingsForTypescript,
+      rules: {
+        ...importX.configs['flat/recommended'].rules,
+        ...rulesForTypescript,
+        ...rulesForStylistic,
+        'import-x/consistent-type-specifier-style': 'error',
+        'import-x/no-named-as-default': 'warn',
+        'import-x/no-cycle': 'error',
+        'import-x/no-unused-modules': 'error',
+        'import-x/no-deprecated': 'warn',
+        'import-x/no-extraneous-dependencies': 'error',
+        'import-x/no-relative-parent-imports': noRelativeParentImports ? 'error' : 'off',
+        ...overrides,
+      },
+    },
+  ])
+}

package/dist/template/src/configs/javascript.ts

@@ -0,0 +1,36 @@
+/**
+ * JavaScript ESLint 基础配置,提供推荐规则和 ES2026+ 全局变量支持
+ */
+import js from '@eslint/js'
+import { defineConfig } from 'eslint/config'
+import globals from 'globals'
+
+import { GLOB_SRC } from '../utils'
+
+import type { JavaScriptOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function javascript(options: JavaScriptOptions = {}): Linter.Config[] {
+  const { files = [GLOB_SRC], overrides = {} } = options
+
+  return defineConfig({
+    name: 'javascript/rules',
+    files,
+    extends: [js.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 'latest',
+      globals: {
+        ...globals.es2026,
+      },
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+      sourceType: 'module',
+    },
+    rules: {
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/jsdoc.ts

@@ -0,0 +1,24 @@
+/**
+ * JSDoc 注释规范配置,使用 TypeScript 优化的推荐规则验证注释正确性
+ */
+import { defineConfig } from 'eslint/config'
+import jsdocPlugin from 'eslint-plugin-jsdoc'
+
+import type { JsdocOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function jsdoc(options: JsdocOptions = {}): Linter.Config[] {
+  const { overrides = {} } = options
+
+  return defineConfig([
+    {
+      name: 'jsdoc/rules',
+      extends: [jsdocPlugin.configs['flat/contents-typescript']],
+      rules: {
+        'jsdoc/match-description': 'off',
+        'jsdoc/informative-docs': 'off',
+        ...overrides,
+      },
+    },
+  ])
+}

package/dist/template/src/configs/nextjs.ts

@@ -0,0 +1,24 @@
+/**
+ * Next.js ESLint 配置,使用官方插件检测 Next.js 最佳实践和 Core Web Vitals 性能优化
+ */
+import nextjsPlugin from '@next/eslint-plugin-next'
+import { defineConfig } from 'eslint/config'
+
+import type { NextjsOptions } from '../types'
+import type { Linter } from 'eslint'
+
+const recommended = nextjsPlugin.configs.recommended as unknown as Linter.Config
+const coreWebVitals = nextjsPlugin.configs['core-web-vitals'] as unknown as Linter.Config
+
+/**
+ * Next.js 规则配置
+ */
+export function nextjs(options: NextjsOptions = {}): Linter.Config[] {
+  const { overrides = {} } = options
+
+  return defineConfig({
+    name: 'nextjs/rules',
+    extends: [recommended, coreWebVitals],
+    rules: overrides,
+  })
+}

package/dist/template/src/configs/package-json.ts

@@ -0,0 +1,32 @@
+/**
+ * Package.json 文件规则配置,检查文件一致性、字段验证和依赖管理
+ */
+import { defineConfig } from 'eslint/config'
+import plugin from 'eslint-plugin-package-json'
+
+import type { PackageJsonOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function packageJson(options: PackageJsonOptions = {}): Linter.Config[] {
+  const { stylistic = true, enforceForPrivate, overrides = {} } = options
+
+  return defineConfig({
+    name: 'package-json/rules',
+    plugins: {
+      'package-json': plugin,
+    },
+    extends: [plugin.configs.recommended],
+    rules: {
+      ...(stylistic ? plugin.configs.stylistic.rules : {}),
+      'package-json/valid-local-dependency': 'off',
+      ...overrides,
+    },
+    ...(enforceForPrivate !== undefined && {
+      settings: {
+        packageJson: {
+          enforceForPrivate,
+        },
+      },
+    }),
+  })
+}

package/dist/template/src/configs/prettier.ts

@@ -0,0 +1,25 @@
+/**
+ * Prettier 代码格式化配置,使用官方推荐规则集
+ */
+import { defineConfig } from 'eslint/config'
+import prettierConfig from 'eslint-plugin-prettier/recommended'
+
+import { GLOB_SRC } from '../utils'
+
+import type { PrettierOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function prettier(options: PrettierOptions = {}): Linter.Config[] {
+  const { overrides = {} } = options
+
+  const files = [GLOB_SRC]
+
+  return defineConfig([
+    {
+      name: 'prettier/rules',
+      files,
+      extends: [prettierConfig],
+      rules: overrides,
+    },
+  ])
+}

package/dist/template/src/configs/react.ts

@@ -0,0 +1,32 @@
+/**
+ * React ESLint 配置,集成 @eslint-react、react-hooks 和 react-refresh 插件
+ */
+import reactPlugin from '@eslint-react/eslint-plugin'
+import { defineConfig } from 'eslint/config'
+import reactHooksPlugin from 'eslint-plugin-react-hooks'
+import reactRefresh from 'eslint-plugin-react-refresh'
+
+import { GLOB_JSX } from '../utils'
+
+import type { ReactOptions } from '../types'
+import type { Linter } from 'eslint'
+
+/**
+ * React 规则配置
+ */
+export function react(options: ReactOptions = {}): Linter.Config[] {
+  const { files = [GLOB_JSX], overrides = {} } = options
+
+  return defineConfig({
+    name: 'react/rules',
+    files,
+    extends: [
+      reactPlugin.configs['recommended-typescript'],
+      reactHooksPlugin.configs.flat['recommended-latest'],
+      reactRefresh.configs.recommended,
+    ],
+    rules: {
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/storybook.ts

@@ -0,0 +1,22 @@
+/**
+ * Storybook ESLint 配置,使用官方插件检测 Storybook 最佳实践
+ */
+import { defineConfig } from 'eslint/config'
+import storybookPlugin from 'eslint-plugin-storybook'
+
+import type { StorybookOptions } from '../types'
+import type { Linter } from 'eslint'
+
+const flatRecommended = storybookPlugin.configs['flat/recommended'] as unknown as Linter.Config
+
+export function storybook(options: StorybookOptions = {}): Linter.Config[] {
+  const { overrides = {} } = options
+
+  return defineConfig({
+    name: 'storybook/recommended',
+    extends: [flatRecommended],
+    rules: {
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/stylistic.ts

@@ -0,0 +1,37 @@
+/**
+ * Stylistic 代码风格配置,提供缩进、引号、逗号等格式化规则
+ */
+import stylisticPlugin from '@stylistic/eslint-plugin'
+import { defineConfig } from 'eslint/config'
+
+import { GLOB_SRC } from '../utils'
+
+import type { StylisticOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function stylistic(options: StylisticOptions = {}): Linter.Config[] {
+  const { overrides = {} } = options
+
+  const files = [GLOB_SRC]
+
+  return defineConfig([
+    {
+      name: 'stylistic/rules',
+      files,
+      extends: [
+        stylisticPlugin.configs.customize({
+          indent: 2,
+          semi: false,
+          quotes: 'single',
+          quoteProps: 'consistent-as-needed',
+          commaDangle: 'always-multiline',
+          arrowParens: true,
+          blockSpacing: true,
+          braceStyle: '1tbs',
+          jsx: true,
+        }),
+      ],
+      rules: overrides,
+    },
+  ])
+}

package/dist/template/src/configs/tailwind.ts

@@ -0,0 +1,32 @@
+/**
+ * Tailwind CSS ESLint 配置，使用官方推荐规则集
+ */
+import { defineConfig } from 'eslint/config'
+import eslintPluginBetterTailwindcss from 'eslint-plugin-better-tailwindcss'
+
+import type { TailwindOptions } from '../types'
+import type { Linter } from 'eslint'
+
+/**
+ * Tailwind CSS 规则配置
+ */
+export function tailwind(options: TailwindOptions = {}): Linter.Config[] {
+  const { files, overrides = {}, entryPoint = 'src/global.css' } = options
+
+  return defineConfig({
+    name: 'tailwind/rules',
+    files: files ?? undefined,
+    extends: [
+      eslintPluginBetterTailwindcss.configs.recommended,
+    ],
+    rules: {
+      'better-tailwindcss/enforce-consistent-line-wrapping': ['error', { printWidth: 0 }],
+      ...overrides,
+    },
+    settings: {
+      'better-tailwindcss': {
+        entryPoint,
+      },
+    },
+  })
+}

package/dist/template/src/configs/typescript.ts

@@ -0,0 +1,51 @@
+/**
+ * TypeScript ESLint 配置,提供类型感知的代码检查(推荐规则 + 风格规则)
+ */
+import { defineConfig } from 'eslint/config'
+import { configs, parser, plugin } from 'typescript-eslint'
+
+import { GLOB_TS } from '../utils'
+
+import type { TypeScriptOptions } from '../types'
+import type { Linter } from 'eslint'
+
+/**
+ * TypeScript 规则配置
+ */
+export function typescript(options: TypeScriptOptions = {}): Linter.Config[] {
+  const { files = [GLOB_TS], tsconfigRootDir, overrides = {} } = options
+
+  return defineConfig({
+    name: 'typescript/rules',
+    files,
+    plugins: {
+      '@typescript-eslint': plugin,
+    },
+    extends: [configs.recommendedTypeChecked, configs.stylisticTypeChecked],
+    languageOptions: {
+      parser,
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: tsconfigRootDir ?? process.cwd(),
+      },
+    },
+    rules: {
+      '@typescript-eslint/consistent-type-definitions': 'off',
+      '@typescript-eslint/consistent-type-imports': 'error',
+      '@typescript-eslint/no-unused-vars': 'off',
+      '@typescript-eslint/no-deprecated': 'warn',
+      '@typescript-eslint/no-inferrable-types': 'off',
+      '@typescript-eslint/unbound-method': 'warn',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        {
+          checksVoidReturn: {
+            attributes: false,
+          },
+        },
+      ],
+
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/unicorn.ts

@@ -0,0 +1,25 @@
+/**
+ * Unicorn ESLint 配置,提供 100+ 强大规则改进代码质量和一致性
+ */
+import { defineConfig } from 'eslint/config'
+import eslintPluginUnicorn from 'eslint-plugin-unicorn'
+
+import { GLOB_SRC } from '../utils'
+
+import type { UnicornOptions } from '../types'
+import type { Linter } from 'eslint'
+
+export function unicorn(options: UnicornOptions = {}): Linter.Config[] {
+  const { files = [GLOB_SRC], overrides = {} } = options
+
+  return defineConfig({
+    name: 'unicorn/rules',
+    files,
+    extends: [eslintPluginUnicorn.configs.recommended],
+    rules: {
+      'unicorn/no-null': 'off',
+      'unicorn/prevent-abbreviations': 'off',
+      ...overrides,
+    },
+  })
+}

package/dist/template/src/configs/vitest.ts

@@ -0,0 +1,56 @@
+/**
+ * Vitest 测试规则配置,包含测试最佳实践和质量保证规则
+ */
+import { fixupPluginRules } from '@eslint/compat'
+import vitestPlugin from '@vitest/eslint-plugin'
+import { defineConfig } from 'eslint/config'
+
+import { GLOB_TESTS, isInEditorEnv } from '../utils'
+
+import type { VitestOptions } from '../types'
+import type { ESLint, Linter } from 'eslint'
+
+export function vitest(options: VitestOptions = {}): Linter.Config[] {
+  const {
+    files = GLOB_TESTS,
+    overrides = {},
+    isInEditor = isInEditorEnv(),
+  } = options
+
+  return defineConfig([
+    {
+      name: 'vitest/rules',
+      files,
+      plugins: {
+        vitest: fixupPluginRules(vitestPlugin as unknown as ESLint.Plugin),
+      },
+      rules: {
+        ...vitestPlugin.configs.recommended.rules,
+
+        'no-console': 'off',
+        'no-restricted-globals': 'off',
+        'no-restricted-syntax': 'off',
+        'no-undef': 'off',
+        '@typescript-eslint/ban-ts-comment': 'off',
+        '@typescript-eslint/explicit-module-boundary-types': 'off',
+        '@typescript-eslint/unbound-method': 'off',
+        'unicorn/no-null': 'off',
+
+        'vitest/consistent-test-it': ['error', { fn: 'it', withinDescribe: 'it' }],
+        'vitest/no-identical-title': 'error',
+        'vitest/prefer-hooks-in-order': 'error',
+        'vitest/prefer-lowercase-title': 'error',
+
+        'vitest/no-disabled-tests': isInEditor ? 'warn' : 'error',
+        'vitest/no-focused-tests': isInEditor ? 'warn' : 'error',
+
+        ...overrides,
+      },
+      settings: {
+        vitest: {
+          typecheck: true,
+        },
+      },
+    },
+  ])
+}

package/dist/template/src/index.ts

@@ -0,0 +1,204 @@
+/**
+ * @workspace/eslint-config
+ *
+ * 统一 ESLint 配置工具
+ *
+ * @example
+ * ```typescript
+ * import { composeConfig } from '@workspace/eslint-config'
+ *
+ * export default composeConfig({
+ *   typescript: { tsconfigRootDir: import.meta.dirname },
+ *   react: true,
+ *   tailwind: true,
+ *   imports: { typescript: true },
+ *   prettier: true,
+ * })
+ * ```
+ */
+
+import { a11y } from './configs/a11y'
+import { boundaries } from './configs/boundaries'
+import { depend } from './configs/depend'
+import { ignores } from './configs/ignores'
+import { imports } from './configs/imports'
+import { javascript } from './configs/javascript'
+import { jsdoc } from './configs/jsdoc'
+import { nextjs } from './configs/nextjs'
+import { packageJson } from './configs/package-json'
+import { prettier } from './configs/prettier'
+import { react } from './configs/react'
+import { storybook } from './configs/storybook'
+import { stylistic } from './configs/stylistic'
+import { tailwind } from './configs/tailwind'
+import { typescript } from './configs/typescript'
+import { unicorn } from './configs/unicorn'
+import { vitest } from './configs/vitest'
+
+import type {
+  A11yOptions,
+  BoundariesOptions,
+  DependOptions,
+  IgnoresOptions,
+  ImportsOptions,
+  JavaScriptOptions,
+  JsdocOptions,
+  NextjsOptions,
+  PackageJsonOptions,
+  PrettierOptions,
+  ReactOptions,
+  StorybookOptions,
+  StylisticOptions,
+  TailwindOptions,
+  TypeScriptOptions,
+  UnicornOptions,
+  VitestOptions,
+} from './types'
+import type { Linter } from 'eslint'
+
+// ============================================================================
+// 类型定义
+// ============================================================================
+
+/**
+ * composeConfig 配置选项
+ *
+ * 每个配置项支持：
+ * - `true` - 使用默认选项
+ * - `对象` - 传入自定义选项
+ * - `false` - 关闭（默认开启的配置需要显式关闭）
+ * - 不写 - 不启用（非默认开启的配置）
+ */
+export interface ComposeConfigOptions {
+  // 基础配置（默认开启）
+  /** 忽略文件配置 @default true */
+  ignores?: boolean | IgnoresOptions
+  /** JavaScript 基础配置 @default true */
+  javascript?: boolean | JavaScriptOptions
+  /** TypeScript 配置 @default true */
+  typescript?: boolean | TypeScriptOptions
+  /** 代码风格规则 @default true */
+  stylistic?: boolean | StylisticOptions
+  /** Unicorn 最佳实践 @default true */
+  unicorn?: boolean | UnicornOptions
+  /** 依赖优化建议 @default true */
+  depend?: boolean | DependOptions
+
+  // 框架配置
+  /** React 配置 */
+  react?: boolean | ReactOptions
+  /** Next.js 配置 */
+  nextjs?: boolean | NextjsOptions
+  /** Tailwind CSS 配置 */
+  tailwind?: boolean | TailwindOptions
+
+  // 工具配置
+  /** Import 排序和规则 */
+  imports?: boolean | ImportsOptions
+  /** Prettier 格式化 */
+  prettier?: boolean | PrettierOptions
+
+  // 质量配置
+  /** 无障碍访问规则 */
+  a11y?: boolean | A11yOptions
+  /** JSDoc 文档规则 */
+  jsdoc?: boolean | JsdocOptions
+  /** 模块边界规则 */
+  boundaries?: boolean | BoundariesOptions
+  /** package.json 规则 */
+  packageJson?: boolean | PackageJsonOptions
+
+  // 测试配置
+  /** Vitest 测试规则 */
+  vitest?: boolean | VitestOptions
+  /** Storybook 规则 */
+  storybook?: boolean | StorybookOptions
+}
+
+// ============================================================================
+// 主函数
+// ============================================================================
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+type ConfigFn = (opts: any) => Linter.Config[]
+
+type ConfigEntry = {
+  key: keyof ComposeConfigOptions
+  fn: ConfigFn
+  defaultOn?: boolean
+  /** 根据全局 options 派生注入值，优先级低于用户配置 */
+  inject?: (options: ComposeConfigOptions) => Record<string, unknown>
+}
+
+const CONFIG_REGISTRY: ConfigEntry[] = [
+  // 默认开启
+  { key: 'ignores', fn: ignores, defaultOn: true },
+  { key: 'javascript', fn: javascript, defaultOn: true },
+  { key: 'typescript', fn: typescript, defaultOn: true },
+  { key: 'stylistic', fn: stylistic, defaultOn: true },
+  { key: 'unicorn', fn: unicorn, defaultOn: true },
+  { key: 'depend', fn: depend, defaultOn: true },
+  // 按需开启（顺序固定，prettier 最后）
+  {
+    key: 'imports',
+    fn: imports,
+    inject: (options) => ({ typescript: options.typescript !== false }),
+  },
+  { key: 'react', fn: react },
+  { key: 'nextjs', fn: nextjs },
+  { key: 'tailwind', fn: tailwind },
+  { key: 'a11y', fn: a11y },
+  { key: 'jsdoc', fn: jsdoc },
+  { key: 'boundaries', fn: boundaries },
+  { key: 'packageJson', fn: packageJson },
+  { key: 'vitest', fn: vitest },
+  { key: 'storybook', fn: storybook },
+  { key: 'prettier', fn: prettier },
+]
+
+/** 组合 ESLint 配置，内部按正确顺序组合 */
+export function composeConfig(options: ComposeConfigOptions = {}): Linter.Config[] {
+  const configs: Linter.Config[] = []
+
+  for (const { key, fn, defaultOn, inject } of CONFIG_REGISTRY) {
+    const opt = options[key]
+    const enabled = defaultOn ? opt !== false : !!opt
+    if (!enabled) continue
+
+    const base = typeof opt === 'object' ? opt : {}
+    const injected = inject ? inject(options) : {}
+    configs.push(...fn({ ...injected, ...base }))
+  }
+
+  return configs
+}
+
+// ============================================================================
+// 类型导出
+// ============================================================================
+
+export type {
+  A11yOptions,
+  BoundariesOptions,
+  DependOptions,
+  IgnoresOptions,
+  ImportsOptions,
+  JavaScriptOptions,
+  JsdocOptions,
+  NextjsOptions,
+  PackageJsonOptions,
+  PrettierOptions,
+  ReactOptions,
+  StorybookOptions,
+  StylisticOptions,
+  TailwindOptions,
+  TypeScriptOptions,
+  UnicornOptions,
+  VitestOptions,
+} from './types'
+
+// ============================================================================
+// 常量导出
+// ============================================================================
+
+export { GLOB_SRC, GLOB_JS, GLOB_TS, GLOB_JSX, GLOB_TESTS, GLOB_JSON, GLOB_MARKDOWN } from './utils'

package/dist/template/src/types.ts

@@ -0,0 +1,152 @@
+import type { RulesConfig } from '@eslint/core'
+
+/**
+ * 规则覆盖选项
+ */
+export interface OptionsOverrides {
+  /**
+   * 自定义规则覆盖
+   */
+  overrides?: Partial<RulesConfig>
+}
+
+/**
+ * 风格化选项
+ */
+export interface OptionsStylistic {
+  /**
+   * 是否启用风格化规则
+   * @default true
+   */
+  stylistic?: boolean
+}
+
+/**
+ * 文件匹配选项
+ */
+export interface OptionsFiles {
+  /**
+   * 自定义文件匹配模式
+   */
+  files?: string[]
+}
+
+/**
+ * TypeScript 配置选项
+ */
+export interface OptionsTypeScript {
+  tsconfigRootDir?: string
+}
+
+/**
+ * Tailwind CSS 配置选项
+ */
+export interface OptionsTailwind {
+  /**
+   * Tailwind CSS 入口文件路径
+   * @default 'src/global.css'
+   */
+  entryPoint?: string
+}
+
+// ============================================================================
+// Config Options 类型
+// ============================================================================
+
+export type A11yOptions = OptionsFiles & OptionsOverrides
+
+export interface BoundariesOptions extends OptionsFiles, OptionsOverrides {
+  elements?: {
+    type: string
+    pattern: string | string[]
+    capture?: string[]
+    mode?: 'file' | 'folder' | 'full'
+  }[]
+  rules?: {
+    from: string | string[]
+    allow?: (string | [string, Record<string, string>])[]
+    disallow?: string[]
+    message?: string
+  }[]
+}
+
+export interface DependOptions extends OptionsOverrides {
+  /**
+   * 预设列表
+   *
+   * - `native`: 检测可用原生 JavaScript API 替代的包(如 `is-nan` → `Number.isNaN()`)
+   * - `microutilities`: 检测微型工具库(一行代码可实现的包)
+   * - `preferred`: 推荐更轻量、维护更好的替代方案
+   *
+   * @default ['native', 'microutilities', 'preferred']
+   */
+  presets?: ('native' | 'microutilities' | 'preferred')[]
+
+  /**
+   * 自定义禁用的模块列表
+   * @default []
+   */
+  modules?: string[]
+
+  /**
+   * 允许使用的模块列表(即使在 presets 中)
+   * @default []
+   */
+  allowed?: string[]
+}
+
+export interface IgnoresOptions {
+  /** 用户自定义忽略规则，传入 false 禁用默认规则 */
+  ignores?: string[] | false
+  /** gitignore 文件路径或启用标志 */
+  gitignore?: string | boolean
+}
+
+export interface ImportsOptions extends OptionsOverrides, OptionsStylistic {
+  /**
+   * 是否启用 TypeScript 支持
+   * 当全局 typescript 开启时，由 composeConfig 自动注入为 true
+   * @default false（独立调用时）/ 跟随全局 typescript 选项（通过 composeConfig）
+   */
+  typescript?: boolean
+  /**
+   * 禁止使用 ../ 父级相对导入
+   * @default false
+   */
+  noRelativeParentImports?: boolean
+}
+
+export type JavaScriptOptions = OptionsFiles & OptionsOverrides
+
+export type JsdocOptions = OptionsOverrides
+
+export type NextjsOptions = OptionsOverrides
+
+export interface PackageJsonOptions extends OptionsOverrides {
+  /**
+   * @default true
+   */
+  stylistic?: boolean
+  /**
+   * @default false
+   */
+  enforceForPrivate?: boolean
+}
+
+export type PrettierOptions = OptionsOverrides
+
+export type ReactOptions = OptionsFiles & OptionsOverrides
+
+export type StorybookOptions = OptionsOverrides
+
+export type StylisticOptions = OptionsOverrides
+
+export type TailwindOptions = OptionsFiles & OptionsOverrides & OptionsTailwind
+
+export type TypeScriptOptions = OptionsFiles & OptionsOverrides & OptionsTypeScript
+
+export type UnicornOptions = OptionsFiles & OptionsOverrides
+
+export type VitestOptions = OptionsFiles & OptionsOverrides & {
+  isInEditor?: boolean
+}

package/dist/template/src/utils.ts

@@ -0,0 +1,80 @@
+/**
+ * 工具函数和常量
+ */
+
+// ============================================================================
+// 环境检测
+// ============================================================================
+
+/**
+ * 检测是否在 Git Hooks 或 lint-staged 中运行
+ */
+function isInGitHooksOrLintStaged(): boolean {
+  const envVars = [
+    process.env['GIT_PARAMS'],
+    process.env['VSCODE_GIT_COMMAND'],
+  ]
+  return envVars.some(Boolean) || process.env['npm_lifecycle_script']?.startsWith('lint-staged') === true
+}
+
+/**
+ * 检测是否在编辑器环境中运行
+ *
+ * 在以下情况返回 false：
+ * - CI 环境
+ * - Git Hooks
+ * - lint-staged
+ *
+ * 在以下情况返回 true：
+ * - VSCode
+ * - JetBrains IDE
+ * - Vim / Neovim
+ */
+export function isInEditorEnv(): boolean {
+  if (process.env['CI'])
+    return false
+  if (isInGitHooksOrLintStaged())
+    return false
+  const envVars = [
+    process.env['VSCODE_PID'],
+    process.env['VSCODE_CWD'],
+    process.env['JETBRAINS_IDE'],
+    process.env['VIM'],
+    process.env['NVIM'],
+  ]
+  return envVars.some(Boolean)
+}
+
+// ============================================================================
+// 文件匹配模式 (Globs)
+// ============================================================================
+
+/**
+ * ESLint 文件匹配模式常量
+ *
+ * 统一的 glob 模式，确保所有配置使用一致的文件匹配规则
+ */
+
+/** 所有 JS/TS 源文件（完整覆盖 ESM/CJS） */
+export const GLOB_SRC = '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'
+
+/** 仅 JavaScript 文件 */
+export const GLOB_JS = '**/*.{js,mjs,cjs,jsx}'
+
+/** 仅 TypeScript 文件 */
+export const GLOB_TS = '**/*.{ts,mts,cts,tsx}'
+
+/** JSX/TSX 文件（React 相关） */
+export const GLOB_JSX = '**/*.{jsx,tsx}'
+
+/** 测试文件 */
+export const GLOB_TESTS: string[] = [
+  '**/*.{test,spec}.{js,mjs,cjs,jsx,ts,mts,cts,tsx}',
+  '**/__tests__/**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}',
+]
+
+/** JSON 文件 */
+export const GLOB_JSON = '**/*.json'
+
+/** Markdown 文件 */
+export const GLOB_MARKDOWN = '**/*.md'

package/dist/template/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@infra-x/typescript-config/tsconfig.library.json",
+  "compilerOptions": {
+    "isolatedDeclarations": false
+  },
+  "include": ["src", "*.config.ts", "eslint.config.mts"]
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@infra-x/create-eslint-config",
+  "type": "module",
+  "version": "0.1.0",
+  "description": "CLI to copy ESLint config source into a monorepo.",
+  "author": "infra-x",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "create-eslint-config": "./dist/index.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.11.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "eslint": "^9.0.0",
+    "tsdown": "^0.18.1",
+    "typescript": "^5.9.3",
+    "@infra-x/eslint-config": "0.1.0",
+    "@infra-x/typescript-config": "0.1.0"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}