@infra-x/create-eslint-config 0.1.4 → 0.2.0

package/dist/index.mjs

@@ -3,24 +3,23 @@ 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, {
+async function getConflicts(templateDir, destDir) {
+	const entries = await readdir(templateDir, {
 		recursive: true,
 		withFileTypes: true
 	});
-	const conflicts$1 = [];
+	const conflicts = [];
 	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);
+		const rel = path.join(entry.parentPath, entry.name).slice(templateDir.length + 1);
+		const destPath = path.join(destDir, rel);
 		try {
 			await access(destPath);
-			conflicts$1.push(rel);
+			conflicts.push(rel);
 		} catch {}
 	}
-	return conflicts$1;
+	return conflicts;
 }
 intro("@infra-x/create-eslint-config");
 const templateDir = path.join(fileURLToPath(new URL(".", import.meta.url)), "template");
@@ -35,6 +34,5 @@ if (conflicts.length > 0) {
 }
 await cp(templateDir, destDir, { recursive: true });
 outro("复制完成！");
-
 //#endregion
-export {  };
+export {};

package/dist/template/.turbo/turbo-build.log

@@ -0,0 +1,13 @@
+
+> @infra-x/eslint-config@0.1.5 build /home/runner/work/infra-code/infra-code/packages/eslint-config
+> tsdown
+
+ℹ tsdown v0.21.3 powered by rolldown v1.0.0-rc.9
+ℹ config file: /home/runner/work/infra-code/infra-code/packages/eslint-config/tsdown.config.ts 
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/index.mjs    17.21 kB │ gzip: 4.74 kB
+ℹ dist/index.d.mts   6.94 kB │ gzip: 2.19 kB
+ℹ 2 files, total: 24.15 kB
+✔ Build complete in 1654ms

package/dist/template/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @infra-x/eslint-config
+
+## 0.1.5
+
+### Patch Changes
+
+- 478b0b3: test changeset flow

package/dist/template/README.md

@@ -1,3 +1,84 @@
 # @infra-x/eslint-config
 
-共享 ESLint flat config 配置工厂。完整使用说明见[根目录 README](../../README.md)。
+Composable ESLint flat config factory for infra-x projects.
+
+## Installation
+
+```bash
+pnpm add -D @infra-x/eslint-config eslint globals
+```
+
+## Usage
+
+```typescript
+// eslint.config.mts
+import { composeConfig } from '@infra-x/eslint-config'
+
+export default composeConfig({
+  typescript: { tsconfigRootDir: import.meta.dirname },
+  react: true,
+  tailwind: true,
+  imports: true,
+  prettier: true,
+})
+```
+
+For multiple config segments (e.g. separate test rules):
+
+> 注意：在多`tsconfig`配置时，`tsc -b`，需要添加 `-b`参数。
+
+```typescript
+// eslint.config.mts
+import { GLOB_TESTS, composeConfig } from '@infra-x/eslint-config'
+import { defineConfig } from 'eslint/config'
+
+const appConfig = defineConfig({
+  extends: composeConfig({
+    typescript: { tsconfigRootDir: import.meta.dirname },
+    imports: true,
+    react: true,
+    nextjs: true,
+  }),
+})
+
+const vitestConfig = defineConfig({
+  files: GLOB_TESTS,
+  extends: composeConfig({
+    typescript: { tsconfigRootDir: import.meta.dirname },
+    vitest: true,
+    unicorn: false,
+    stylistic: false,
+    depend: false,
+  }),
+})
+
+export default [...appConfig, ...vitestConfig]
+```
+
+Each option accepts `true` (defaults), an options object, or `false` (disable).
+
+## Options
+
+Default-on: `ignores` · `javascript` · `typescript` · `stylistic` · `unicorn` · `depend` · `configFiles`
+
+Opt-in:
+
+| Option | Description |
+|---|---|
+| `react` | React + react-hooks rules; set `vite: true` for react-refresh |
+| `nextjs` | Next.js rules |
+| `tailwind` | Tailwind CSS class ordering (`entryPoint` defaults to `src/global.css`) |
+| `imports` | Import ordering and resolution |
+| `prettier` | Prettier formatting (should be last) |
+| `a11y` | Accessibility rules |
+| `jsdoc` | JSDoc rules |
+| `boundaries` | Module boundary enforcement |
+| `packageJson` | `package.json` rules |
+| `vitest` | Vitest testing rules |
+| `storybook` | Storybook rules |
+
+All options support an `overrides` field for custom rule overrides, and most accept a `files` glob array.
+
+## Roadmap
+
+- **oxlint 集成**：计划引入 oxlint 作为快速检查层，通过 `eslint-plugin-oxlint` 禁用 ESLint 中与 oxlint 重复的规则（core/typescript/unicorn），减少 ESLint 规则数量约 50%，显著提升 CI lint 速度

package/dist/template/eslint.config.mts

@@ -7,7 +7,7 @@ const config: Linter.Config[] = composeConfig({
   imports: {
     typescript: true,
     overrides: {
-      // 本包内部使用相对导入，因为没有配置路径别名
+      // This package uses relative imports internally since no path aliases are configured
       'no-restricted-imports': 'off',
     },
   },

package/dist/template/package.json

@@ -19,6 +19,7 @@
     "typecheck": "tsc --noEmit"
   },
   "devDependencies": {
+    "@infra-x/typescript-config": "0.1.6",
     "@types/eslint-plugin-jsx-a11y": "^6.10.1",
     "@types/node": "^25.0.3",
     "eslint": "^9.39.2",
@@ -32,23 +33,24 @@
     "@eslint-react/eslint-plugin": "^2.13.0",
     "@eslint/compat": "1.4.1",
     "@eslint/core": "0.17.0",
-    "@eslint/js": "^9.39.3",
+    "@eslint/js": "^10.0.1",
     "@next/eslint-plugin-next": "^16.1.6",
     "@stylistic/eslint-plugin": "^5.9.0",
     "@vitest/eslint-plugin": "^1.6.9",
+    "eslint-config-prettier": "^10.1.8",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-better-tailwindcss": "^4.3.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-depend": "^1.5.0",
+    "eslint-plugin-import-x": "4.16.2",
+    "eslint-plugin-jsdoc": "^62.7.1",
     "eslint-plugin-jsx-a11y": "^6.10.2",
-    "eslint-plugin-package-json": "^0.64.0",
+    "eslint-plugin-package-json": "^0.91.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.12",
-    "eslint-plugin-unicorn": "^57.0.0",
+    "eslint-plugin-react-refresh": "^0.5.2",
+    "eslint-plugin-storybook": "^10.2.14",
+    "eslint-plugin-unicorn": "^63.0.0",
     "typescript-eslint": "^8.56.1"
   },
   "peerDependencies": {
@@ -56,6 +58,21 @@
     "globals": "16.5.0",
     "jiti": "2.6.1",
     "prettier": "^3.7.4",
+    "storybook": ">=10.0.0",
     "typescript": "^5.9.3"
+  },
+  "peerDependenciesMeta": {
+    "jiti": {
+      "optional": true
+    },
+    "prettier": {
+      "optional": true
+    },
+    "storybook": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
   }
 }

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

@@ -1,5 +1,5 @@
 /**
- * eslint-plugin-jsx-a11y 配置,用于检测 JSX 中的无障碍问题(WCAG 标准)
+ * eslint-plugin-jsx-a11y configuration for detecting accessibility issues in JSX (WCAG standard)
  */
 import { defineConfig } from 'eslint/config'
 import jsxA11y from 'eslint-plugin-jsx-a11y'
@@ -10,7 +10,7 @@ import type { A11yOptions } from '../types'
 import type { Linter } from 'eslint'
 
 /**
- * 可访问性规则配置
+ * Accessibility rule configuration
  */
 export function a11y(options: A11yOptions = {}): Linter.Config[] {
   const { files = [GLOB_JSX], overrides = {} } = options

package/dist/template/src/configs/better-tailwindcss.ts

@@ -1,5 +1,5 @@
 /**
- * Tailwind CSS ESLint 配置，使用官方推荐规则集
+ * Tailwind CSS ESLint configuration using the official recommended ruleset
  */
 import { defineConfig } from 'eslint/config'
 import eslintPluginBetterTailwindcss from 'eslint-plugin-better-tailwindcss'
@@ -10,7 +10,7 @@ import type { TailwindOptions } from '../types'
 import type { Linter } from 'eslint'
 
 /**
- * Tailwind CSS 规则配置
+ * Tailwind CSS rule configuration
  */
 export function tailwind(options: TailwindOptions = {}): Linter.Config[] {
   const { files = [GLOB_JSX], overrides = {}, entryPoint = 'src/global.css' } = options

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

@@ -1,5 +1,5 @@
 /**
- * eslint-plugin-boundaries 配置，用于强制执行架构边界规则
+ * eslint-plugin-boundaries configuration for enforcing architectural boundary rules
  */
 import { defineConfig } from 'eslint/config'
 import boundariesPlugin from 'eslint-plugin-boundaries'

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

@@ -1,13 +1,12 @@
 /**
- * 依赖优化规则配置,检测可用原生 API 替代的包和微型工具库
+ * Dependency optimization rule configuration for detecting packages replaceable with native APIs or micro-utilities
  */
-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'
+import type { Linter } from 'eslint'
 
 const DEFAULT_PRESETS: DependOptions['presets'] = ['native', 'microutilities', 'preferred']
 
@@ -19,7 +18,7 @@ export function depend(options: DependOptions = {}): Linter.Config[] {
       name: 'depend/rules',
       files: [GLOB_SRC],
       plugins: {
-        depend: fixupPluginRules(dependPlugin as unknown as ESLint.Plugin),
+        depend: dependPlugin,
       },
       rules: {
         'depend/ban-dependencies': [

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

@@ -1,5 +1,5 @@
 /**
- * ESLint 忽略文件配置,支持默认忽略规则和 .gitignore 导入
+ * ESLint ignore configuration with built-in default ignore patterns and .gitignore integration
  */
 import { existsSync } from 'node:fs'
 import path from 'node:path'
@@ -10,31 +10,31 @@ import type { IgnoresOptions } from '../types'
 import type { Linter } from 'eslint'
 
 /**
- * 默认忽略的文件和目录
+ * Default ignored files and directories
  */
 export const DEFAULT_IGNORES: string[] = [
-  // 依赖目录
+  // Dependency directories
   '**/node_modules/**',
   '**/.pnp.*',
 
-  // 构建产物
+  // Build artifacts
   '**/dist/**',
   '**/build/**',
   '**/out/**',
   '**/.next/**',
 
-  // 缓存目录
+  // Cache directories
   '**/.cache/**',
   '**/.turbo/**',
   '**/.eslintcache',
 
-  // 版本控制
+  // Version control
   '**/.git/**',
   '**/.svn/**',
   '**/.hg/**',
   '**/public/**',
 
-  // 类型文件
+  // Type declaration files
   '**/*.d.ts',
 ]
 

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

@@ -1,5 +1,5 @@
 /**
- * Import 模块导入规则配置,提供导入排序、循环依赖检测和 TypeScript 支持
+ * Import rule configuration providing import ordering, circular dependency detection, and TypeScript support
  */
 import { defineConfig } from 'eslint/config'
 import { importX } from 'eslint-plugin-import-x'
@@ -10,14 +10,19 @@ 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 { overrides = {}, stylistic = true, typescript = false, noRelativeParentImports = false, tsconfigRootDir } = options
 
   const files = [GLOB_SRC]
 
   const settingsForTypescript = typescript
     ? {
         ...importX.configs['flat/recommended'].settings,
-        'import-x/resolver': { typescript: { alwaysTryTypes: true } },
+        'import-x/resolver': {
+          typescript: {
+            alwaysTryTypes: true,
+            ...(tsconfigRootDir && { project: tsconfigRootDir }),
+          },
+        },
       }
     : {}
 

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

@@ -1,5 +1,5 @@
 /**
- * JavaScript ESLint 基础配置,提供推荐规则和 ES2026+ 全局变量支持
+ * JavaScript ESLint base configuration with recommended rules and ES2026+ global variable support
  */
 import js from '@eslint/js'
 import { defineConfig } from 'eslint/config'

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

@@ -1,5 +1,5 @@
 /**
- * JSDoc 注释规范配置,使用 TypeScript 优化的推荐规则验证注释正确性
+ * JSDoc comment validation configuration using TypeScript-optimized recommended rules
  */
 import { defineConfig } from 'eslint/config'
 import jsdocPlugin from 'eslint-plugin-jsdoc'

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

@@ -1,5 +1,5 @@
 /**
- * Next.js ESLint 配置,使用官方插件检测 Next.js 最佳实践和 Core Web Vitals 性能优化
+ * Next.js ESLint configuration using the official plugin for best practices and Core Web Vitals enforcement
  */
 import nextjsPlugin from '@next/eslint-plugin-next'
 import { defineConfig } from 'eslint/config'
@@ -11,7 +11,7 @@ const recommended = nextjsPlugin.configs.recommended as unknown as Linter.Config
 const coreWebVitals = nextjsPlugin.configs['core-web-vitals'] as unknown as Linter.Config
 
 /**
- * Next.js 规则配置
+ * Next.js rule configuration
  */
 export function nextjs(options: NextjsOptions = {}): Linter.Config[] {
   const { overrides = {} } = options

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

@@ -1,5 +1,5 @@
 /**
- * Package.json 文件规则配置,检查文件一致性、字段验证和依赖管理
+ * package.json rule configuration for file consistency checks, field validation, and dependency management
  */
 import { defineConfig } from 'eslint/config'
 import plugin from 'eslint-plugin-package-json'

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

@@ -1,5 +1,5 @@
 /**
- * Prettier 代码格式化配置,使用官方推荐规则集
+ * Prettier code formatting configuration using the official recommended ruleset
  */
 import { defineConfig } from 'eslint/config'
 import prettierConfig from 'eslint-plugin-prettier/recommended'

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

@@ -1,5 +1,5 @@
 /**
- * React ESLint 配置,集成 @eslint-react、react-hooks 和 react-refresh 插件
+ * React ESLint configuration integrating @eslint-react, react-hooks, and react-refresh plugins
  */
 import reactPlugin from '@eslint-react/eslint-plugin'
 import { defineConfig } from 'eslint/config'
@@ -12,10 +12,10 @@ import type { ReactOptions } from '../types'
 import type { Linter } from 'eslint'
 
 /**
- * React 规则配置
+ * React rule configuration
  */
 export function react(options: ReactOptions = {}): Linter.Config[] {
-  const { files = [GLOB_JSX], overrides = {} } = options
+  const { files = [GLOB_JSX], overrides = {}, vite = false } = options
 
   return defineConfig({
     name: 'react/rules',
@@ -23,7 +23,7 @@ export function react(options: ReactOptions = {}): Linter.Config[] {
     extends: [
       reactPlugin.configs['recommended-typescript'],
       reactHooksPlugin.configs.flat['recommended-latest'],
-      reactRefresh.configs.recommended,
+      ...(vite ? [reactRefresh.configs.recommended] : []),
     ],
     rules: {
       ...overrides,

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

@@ -1,5 +1,5 @@
 /**
- * Storybook ESLint 配置,使用官方插件检测 Storybook 最佳实践
+ * Storybook ESLint configuration using the official plugin for best practices enforcement
  */
 import { defineConfig } from 'eslint/config'
 import storybookPlugin from 'eslint-plugin-storybook'

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

@@ -1,5 +1,5 @@
 /**
- * Stylistic 代码风格配置,提供缩进、引号、逗号等格式化规则
+ * Stylistic code style configuration providing formatting rules for indentation, quotes, commas, and more
  */
 import stylisticPlugin from '@stylistic/eslint-plugin'
 import { defineConfig } from 'eslint/config'

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

@@ -1,5 +1,5 @@
 /**
- * TypeScript ESLint 配置,提供类型感知的代码检查(推荐规则 + 风格规则)
+ * TypeScript ESLint configuration with type-aware linting (recommended rules + stylistic rules)
  */
 import { defineConfig } from 'eslint/config'
 import { configs, parser, plugin } from 'typescript-eslint'
@@ -10,7 +10,7 @@ import type { TypeScriptOptions } from '../types'
 import type { Linter } from 'eslint'
 
 /**
- * TypeScript 规则配置
+ * TypeScript rule configuration
  */
 export function typescript(options: TypeScriptOptions = {}): Linter.Config[] {
   const { files = [GLOB_TS], tsconfigRootDir, overrides = {} } = options

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

@@ -1,5 +1,5 @@
 /**
- * Unicorn ESLint 配置,提供 100+ 强大规则改进代码质量和一致性
+ * Unicorn ESLint configuration providing 100+ powerful rules to improve code quality and consistency
  */
 import { defineConfig } from 'eslint/config'
 import eslintPluginUnicorn from 'eslint-plugin-unicorn'

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

@@ -1,14 +1,13 @@
 /**
- * Vitest 测试规则配置,包含测试最佳实践和质量保证规则
+ * Vitest test rule configuration with testing best practices and quality assurance rules
  */
-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'
+import type { Linter } from 'eslint'
 
 export function vitest(options: VitestOptions = {}): Linter.Config[] {
   const {
@@ -22,7 +21,7 @@ export function vitest(options: VitestOptions = {}): Linter.Config[] {
       name: 'vitest/rules',
       files,
       plugins: {
-        vitest: fixupPluginRules(vitestPlugin as unknown as ESLint.Plugin),
+        vitest: vitestPlugin,
       },
       rules: {
         ...vitestPlugin.configs.recommended.rules,

package/dist/template/src/index.ts

@@ -1,7 +1,7 @@
 /**
  * @workspace/eslint-config
  *
- * 统一 ESLint 配置工具
+ * Composable ESLint configuration factory
  *
  * @example
  * ```typescript
@@ -60,68 +60,68 @@ import type {
 import type { Linter } from 'eslint'
 
 // ============================================================================
-// 类型定义
+// Type definitions
 // ============================================================================
 
 /**
- * composeConfig 配置选项
+ * Options for composeConfig
  *
- * 每个配置项支持：
- * - `true` - 使用默认选项
- * - `对象` - 传入自定义选项
- * - `false` - 关闭（默认开启的配置需要显式关闭）
- * - 不写 - 不启用（非默认开启的配置）
+ * Each config entry accepts:
+ * - `true` - enable with default options
+ * - `object` - enable with custom options
+ * - `false` - explicitly disable (required for configs that are on by default)
+ * - omitted - leave disabled (for configs that are off by default)
  */
 export interface ComposeConfigOptions {
-  // 基础配置（默认开启）
-  /** 忽略文件配置 @default true */
+  // Base configuration (enabled by default)
+  /** Ignore patterns configuration @default true */
   ignores?: boolean | IgnoresOptions
-  /** JavaScript 基础配置 @default true */
+  /** JavaScript base configuration @default true */
   javascript?: boolean | JavaScriptOptions
-  /** TypeScript 配置 @default true */
+  /** TypeScript configuration @default true */
   typescript?: boolean | TypeScriptOptions
-  /** 代码风格规则 @default true */
+  /** Code style rules @default true */
   stylistic?: boolean | StylisticOptions
-  /** Unicorn 最佳实践 @default true */
+  /** Unicorn best practices @default true */
   unicorn?: boolean | UnicornOptions
-  /** 依赖优化建议 @default true */
+  /** Dependency optimization suggestions @default true */
   depend?: boolean | DependOptions
-  /** config 文件（*.config.ts）专属规则（不启用类型检查）@default true */
+  /** Rules for config files (*.config.ts) without type-checking @default true */
   configFiles?: boolean
 
-  // 框架配置
-  /** React 配置 */
+  // Framework configuration
+  /** React configuration */
   react?: boolean | ReactOptions
-  /** Next.js 配置 */
+  /** Next.js configuration */
   nextjs?: boolean | NextjsOptions
-  /** Tailwind CSS 配置 */
+  /** Tailwind CSS configuration */
   tailwind?: boolean | TailwindOptions
 
-  // 工具配置
-  /** Import 排序和规则 */
+  // Tooling configuration
+  /** Import ordering and rules */
   imports?: boolean | ImportsOptions
-  /** Prettier 格式化 */
+  /** Prettier formatting */
   prettier?: boolean | PrettierOptions
 
-  // 质量配置
-  /** 无障碍访问规则 */
+  // Quality configuration
+  /** Accessibility rules */
   a11y?: boolean | A11yOptions
-  /** JSDoc 文档规则 */
+  /** JSDoc documentation rules */
   jsdoc?: boolean | JsdocOptions
-  /** 模块边界规则 */
+  /** Module boundary rules */
   boundaries?: boolean | BoundariesOptions
-  /** package.json 规则 */
+  /** package.json rules */
   packageJson?: boolean | PackageJsonOptions
 
-  // 测试配置
-  /** Vitest 测试规则 */
+  // Testing configuration
+  /** Vitest testing rules */
   vitest?: boolean | VitestOptions
-  /** Storybook 规则 */
+  /** Storybook rules */
   storybook?: boolean | StorybookOptions
 }
 
 // ============================================================================
-// 主函数
+// Core function
 // ============================================================================
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -131,12 +131,12 @@ type ConfigEntry = {
   key: keyof ComposeConfigOptions
   fn: ConfigFn
   defaultOn?: boolean
-  /** 根据全局 options 派生注入值，优先级低于用户配置 */
+  /** Values derived from global options to inject; overridden by explicit user config */
   inject?: (options: ComposeConfigOptions) => Record<string, unknown>
 }
 
 const CONFIG_REGISTRY: ConfigEntry[] = [
-  // 默认开启
+  // Enabled by default
   { key: 'ignores', fn: ignores, defaultOn: true },
   { key: 'javascript', fn: javascript, defaultOn: true },
   {
@@ -147,11 +147,16 @@ const CONFIG_REGISTRY: ConfigEntry[] = [
   { key: 'stylistic', fn: stylistic, defaultOn: true },
   { key: 'unicorn', fn: unicorn, defaultOn: true },
   { key: 'depend', fn: depend, defaultOn: true },
-  // 按需开启（顺序固定，prettier 最后）
+  // Opt-in (order is fixed; prettier must come last)
   {
     key: 'imports',
     fn: imports,
-    inject: (options) => ({ typescript: options.typescript !== false }),
+    inject: (options) => ({
+      typescript: options.typescript !== false,
+      tsconfigRootDir: typeof options.typescript === 'object'
+        ? options.typescript.tsconfigRootDir
+        : undefined,
+    }),
   },
   { key: 'react', fn: react },
   { key: 'nextjs', fn: nextjs },
@@ -165,7 +170,7 @@ const CONFIG_REGISTRY: ConfigEntry[] = [
   { key: 'prettier', fn: prettier },
 ]
 
-/** 组合 ESLint 配置，内部按正确顺序组合 */
+/** Composes ESLint configs in the correct internal order */
 export function composeConfig(options: ComposeConfigOptions = {}): Linter.Config[] {
   const configs: Linter.Config[] = []
 
@@ -202,7 +207,7 @@ export function composeConfig(options: ComposeConfigOptions = {}): Linter.Config
 }
 
 // ============================================================================
-// 类型导出
+// Type exports
 // ============================================================================
 
 export type {
@@ -226,7 +231,7 @@ export type {
 } from './types'
 
 // ============================================================================
-// 常量导出
+// Constant exports
 // ============================================================================
 
 export { GLOB_SRC, GLOB_JS, GLOB_TS, GLOB_JSX, GLOB_TESTS, GLOB_JSON, GLOB_MARKDOWN } from './utils'

package/dist/template/src/types.ts

@@ -1,38 +1,38 @@
 import type { RulesConfig } from '@eslint/core'
 
 /**
- * 规则覆盖选项
+ * Rule override options
  */
 export interface OptionsOverrides {
   /**
-   * 自定义规则覆盖
+   * Custom rule overrides
    */
   overrides?: Partial<RulesConfig>
 }
 
 /**
- * 风格化选项
+ * Stylistic options
  */
 export interface OptionsStylistic {
   /**
-   * 是否启用风格化规则
+   * Whether to enable stylistic rules
    * @default true
    */
   stylistic?: boolean
 }
 
 /**
- * 文件匹配选项
+ * File matching options
  */
 export interface OptionsFiles {
   /**
-   * 自定义文件匹配模式
+   * Custom file glob patterns
    */
   files?: string[]
 }
 
 /**
- * TypeScript 配置选项
+ * TypeScript configuration options
  */
 export interface OptionsTypeScript {
   tsconfigRootDir?: string
@@ -41,18 +41,18 @@ export interface OptionsTypeScript {
 }
 
 /**
- * Tailwind CSS 配置选项
+ * Tailwind CSS configuration options
  */
 export interface OptionsTailwind {
   /**
-   * Tailwind CSS 入口文件路径
+   * Path to the Tailwind CSS entry file
    * @default 'src/global.css'
    */
   entryPoint?: string
 }
 
 // ============================================================================
-// Config Options 类型
+// Config option types
 // ============================================================================
 
 export type A11yOptions = OptionsFiles & OptionsOverrides
@@ -74,48 +74,53 @@ export interface BoundariesOptions extends OptionsFiles, OptionsOverrides {
 
 export interface DependOptions extends OptionsOverrides {
   /**
-   * 预设列表
+   * Preset list
    *
-   * - `native`: 检测可用原生 JavaScript API 替代的包(如 `is-nan` → `Number.isNaN()`)
-   * - `microutilities`: 检测微型工具库(一行代码可实现的包)
-   * - `preferred`: 推荐更轻量、维护更好的替代方案
+   * - `native`: Flags packages replaceable with native JavaScript APIs (e.g. `is-nan` → `Number.isNaN()`)
+   * - `microutilities`: Flags micro-utility packages implementable in a single line
+   * - `preferred`: Recommends lighter-weight, better-maintained alternatives
    *
    * @default ['native', 'microutilities', 'preferred']
    */
   presets?: ('native' | 'microutilities' | 'preferred')[]
 
   /**
-   * 自定义禁用的模块列表
+   * Additional modules to ban
    * @default []
    */
   modules?: string[]
 
   /**
-   * 允许使用的模块列表(即使在 presets 中)
+   * Modules to allow even if matched by a preset
    * @default []
    */
   allowed?: string[]
 }
 
 export interface IgnoresOptions {
-  /** 用户自定义忽略规则，传入 false 禁用默认规则 */
+  /** Custom ignore patterns; pass false to disable the built-in defaults */
   ignores?: string[] | false
-  /** gitignore 文件路径或启用标志 */
+  /** Path to .gitignore file, or a boolean to enable/disable auto-detection */
   gitignore?: string | boolean
 }
 
 export interface ImportsOptions extends OptionsOverrides, OptionsStylistic {
   /**
-   * 是否启用 TypeScript 支持
-   * 当全局 typescript 开启时，由 composeConfig 自动注入为 true
-   * @default false（独立调用时）/ 跟随全局 typescript 选项（通过 composeConfig）
+   * Whether to enable TypeScript support
+   * Automatically injected as true by composeConfig when the global typescript option is enabled
+   * @default false (standalone) / follows global typescript option (via composeConfig)
    */
   typescript?: boolean
   /**
-   * 禁止使用 ../ 父级相对导入
+   * Disallow parent-relative imports (paths starting with ../)
    * @default false
    */
   noRelativeParentImports?: boolean
+  /**
+   * Root directory for tsconfig.json lookup; restricts resolver scope in monorepo to avoid cross-app漫游
+   * Automatically injected by composeConfig from the global typescript.tsconfigRootDir option
+   */
+  tsconfigRootDir?: string
 }
 
 export type JavaScriptOptions = OptionsFiles & OptionsOverrides
@@ -137,7 +142,13 @@ export interface PackageJsonOptions extends OptionsOverrides {
 
 export type PrettierOptions = OptionsOverrides
 
-export type ReactOptions = OptionsFiles & OptionsOverrides
+export interface ReactOptions extends OptionsFiles, OptionsOverrides {
+  /**
+   * Whether to enable react-refresh plugin (for Vite projects).
+   * @default false
+   */
+  vite?: boolean
+}
 
 export type StorybookOptions = OptionsOverrides
 

package/dist/template/src/utils.ts

@@ -1,13 +1,13 @@
 /**
- * 工具函数和常量
+ * Utility functions and constants
  */
 
 // ============================================================================
-// 环境检测
+// Environment detection
 // ============================================================================
 
 /**
- * 检测是否在 Git Hooks 或 lint-staged 中运行
+ * Detects whether running inside Git Hooks or lint-staged
  */
 function isInGitHooksOrLintStaged(): boolean {
   const envVars = [
@@ -18,14 +18,14 @@ function isInGitHooksOrLintStaged(): boolean {
 }
 
 /**
- * 检测是否在编辑器环境中运行
+ * Detects whether running in an editor environment
  *
- * 在以下情况返回 false：
- * - CI 环境
+ * Returns false when:
+ * - CI environment
  * - Git Hooks
  * - lint-staged
  *
- * 在以下情况返回 true：
+ * Returns true when:
  * - VSCode
  * - JetBrains IDE
  * - Vim / Neovim
@@ -46,35 +46,35 @@ export function isInEditorEnv(): boolean {
 }
 
 // ============================================================================
-// 文件匹配模式 (Globs)
+// File matching patterns (Globs)
 // ============================================================================
 
 /**
- * ESLint 文件匹配模式常量
+ * ESLint file glob pattern constants
  *
- * 统一的 glob 模式，确保所有配置使用一致的文件匹配规则
+ * Unified glob patterns to ensure consistent file matching across all configurations
  */
 
-/** 所有 JS/TS 源文件（完整覆盖 ESM/CJS） */
+/** All JS/TS source files (full ESM/CJS coverage) */
 export const GLOB_SRC = '**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx}'
 
-/** 仅 JavaScript 文件 */
+/** JavaScript files only */
 export const GLOB_JS = '**/*.{js,mjs,cjs,jsx}'
 
-/** 仅 TypeScript 文件 */
+/** TypeScript files only */
 export const GLOB_TS = '**/*.{ts,mts,cts,tsx}'
 
-/** JSX/TSX 文件（React 相关） */
+/** JSX/TSX files (React-related) */
 export const GLOB_JSX = '**/*.{jsx,tsx}'
 
-/** 测试文件 */
+/** Test files */
 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 文件 */
+/** JSON files */
 export const GLOB_JSON = '**/*.json'
 
-/** Markdown 文件 */
+/** Markdown files */
 export const GLOB_MARKDOWN = '**/*.md'

package/dist/template/tsconfig.json

@@ -3,6 +3,6 @@
   "include": ["src", "*.config.ts", "*.config.mts"],
   "compilerOptions": {
     "types": ["node"],
-    "isolatedDeclarations": false // 减少维护，在那时关闭吧，不然 config 需要繁琐的配置
+    "isolatedDeclarations": false // Disabled to reduce maintenance overhead; enabling it would require verbose type annotations across configs
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@infra-x/create-eslint-config",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "CLI to copy ESLint config source into a monorepo.",
   "author": "infra-x",
   "license": "MIT",
@@ -20,27 +20,24 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
-    "@clack/prompts": "^0.11.0"
+    "@clack/prompts": "^1.0.1"
   },
   "devDependencies": {
-    "@infra-x/eslint-config": "workspace:*",
-    "@infra-x/typescript-config": "workspace:*",
-    "@types/node": "^25.3.1",
-    "eslint": "^9.39.3",
-    "tsdown": "^0.18.4",
-    "typescript": "^5.9.3"
+    "@types/node": "^25.3.3",
+    "eslint": "^10.0.2",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
+    "@infra-x/eslint-config": "0.1.5",
+    "@infra-x/typescript-config": "0.1.6"
   },
-  "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"
   }
-}
+}