@july_cm/eslint-config 2.5.0 → 2.5.2

package/README.md

@@ -6,25 +6,18 @@
 [![NPM Version](https://img.shields.io/npm/v/%40july_cm%2Feslint-config)](https://www.npmjs.com/package/@july_cm/eslint-config)
 [![codecov](https://codecov.io/gh/JxJuly/eslint-config/branch/main/graph/badge.svg?token=T1E32RHZB7)](https://codecov.io/gh/JxJuly/eslint-config)
 
-This is my common ESlint configuration.
+Shared ESLint config for July's projects.
 
-It depends on ESLint v9 or later and is only compatible with Flat Configuration.
-
-❌ [legacy configuration](https://eslint.org/docs/latest/use/configure/configuration-files-deprecated) (legacy: `.eslintrc*`)
-
-✅ [flat configuration](https://eslint.org/docs/latest/use/configure/configuration-files-new) (new: `eslint.config.js`)
+Requires ESLint v10 or later, only compatible with [flat configuration](https://eslint.org/docs/latest/use/configure/configuration-files-new) (`eslint.config.js`).
 
 ## Features
 
-- ✅ Out-of-the-box and lightweight JavaScript ESLint configuration
-
-- ✅ Out-of-the-box and lightweight TypeScript ESLint configuration
-
-- ✅ Out-of-the-box and lightweight CSS ESLint configuration
-
-- ✅ Support for package.json field sorting, especially dependencies and other fields
-
-- ✅ Code style checking with Prettier rules
+- ✅ Out-of-the-box JavaScript ESLint configuration
+- ✅ Out-of-the-box TypeScript ESLint configuration
+- ✅ Out-of-the-box CSS ESLint configuration (with Tailwind CSS v4 support)
+- ✅ Comprehensive `package.json` field sorting (all npm standard fields + sub-field ordering)
+- ✅ Automatic import/export sorting via `eslint-plugin-simple-import-sort`
+- ✅ Integrated Prettier formatting rules (no need for a separate Prettier extension)
 
 ## Installation
 
@@ -32,17 +25,17 @@ It depends on ESLint v9 or later and is only compatible with Flat Configuration.
 npm install --save-dev eslint @july_cm/eslint-config
 ```
 
-`@july_cm/eslint-config` does not install ESLint for you. You must install these yourself.
+`@july_cm/eslint-config` does not install ESLint for you. You must install it yourself.
 
 ## Quick Start
 
-Flat configuration allows you to use specific programming language configurations or directly use the recommended configuration.
+You can use individual language configurations or the `recommended` preset directly.
 
-When using `recommended` directly, you don't need to worry about `.ts` files being matched by `javascript` rules. This package has internally isolated the rules to ensure stable rules and performance.
+When using `recommended`, you don't need to worry about `.ts` files being matched by `javascript` rules — rules are internally isolated per language.
 
 ```javascript
 // eslint.config.js
-const * as config from '@july_cm/eslint-config';
+import * as config from '@july_cm/eslint-config';
 
 // only javascript
 export default config.javascript;
@@ -50,86 +43,102 @@ export default config.javascript;
 // only typescript
 export default config.typescript;
 
+// only css
+export default config.css;
+
+// only package.json sorting
+export default config.packageJson;
+
 /**
- * recommended
+ * recommended (includes all of the above)
  * - javascript
  * - typescript
+ * - css
  * - package.json
  */
 export default config.recommended;
 ```
 
-⚠️ Note: If the `type` field in `package.json` is not explicitly set to `module`, the filename needs to be changed to `eslint.config.mjs`.
+⚠️ If the `type` field in `package.json` is not set to `"module"`, rename the config file to `eslint.config.mjs`.
 
 ## Custom Rules
 
-Custom rules or configurations are supported. It is recommended to use ESLint's official `defineConfig` function as the merge function:
+You can extend or override rules using ESLint's `defineConfig`:
 
 ```javascript
 // eslint.config.js
 import { recommended } from '@july_cm/eslint-config';
-import { defineConfig } from 'eslint/config';
-
-export default defineConfig(recommended, {
-  ignores: ["dist"],
-  rules: {}
-})
+import { defineConfig, globalIgnores } from 'eslint/config';
+
+export default defineConfig(
+  globalIgnores(['dist']),
+  recommended,
+  {
+    rules: {
+      // your custom rules
+    },
+  }
+);
 ```
 
+## Included Configurations
 
-## Abort `package.json` key order
+### JavaScript
 
-The sorting functionality is implemented based on [eslint-plugin-jsonc](https://github.com/ota-meshi/eslint-plugin-jsonc) and [prettier](https://github.com/prettier/prettier).
+- Extends `@eslint/js` recommended rules
+- Auto-sorts imports and exports
+- Prettier formatting (single quotes, semicolons, 80 char width, ES5 trailing commas)
+- Files: `**/*.{js,mjs,cjs,jsx}`
 
-```javascript
-[{
-  pathPattern: '^$',
-  order: ['name', 'version', 'author', 'exports', 'types', 'main', 'module', 'scripts', 'dependencies', 'devDependencies'],
-},
-{
-  pathPattern: '^(?:dev|peer|optional|bundled)?[Dd]ependencies$',
-  order: { type: 'asc' },
-},
-{
-  pathPattern: 'exports',
-  order: ['types', 'require', 'import']
-}]
-```
+### TypeScript
+
+- Extends `@eslint/js` recommended + `typescript-eslint` recommended rules
+- Enforces `type` imports (`@typescript-eslint/consistent-type-imports`)
+- Auto-sorts imports and exports
+- Prettier formatting
+- Files: `**/*.{ts,tsx}`
+
+### CSS
+
+- Powered by `@eslint/css` with Tailwind CSS v4 custom syntax support
+- Prettier formatting
+- Files: `**/*.css`
 
-## With `Visual Studio Code`
+### package.json
 
-1. Install [VS Code ESLint extension](https://github.com/microsoft/vscode-eslint).
+- Sorts all npm standard fields into logical groups: metadata → environment → entries → scripts → dependencies → publish
+- Sub-field ordering for `exports`, `repository`, `bugs`, `engines`, `scripts`, etc.
+- Dependencies sorted alphabetically
 
-    Check if there are other plugins set as the default formatter in the editor. If so, they need to be removed or replaced with ESLint:
+## With Visual Studio Code
+
+1. Install the [VS Code ESLint extension](https://github.com/microsoft/vscode-eslint).
+
+    Make sure ESLint is set as the default formatter:
 
     ```json
     {
-      "editor.defaultFormatter": "dbaeumer.vscode-eslint",
+      "editor.defaultFormatter": "dbaeumer.vscode-eslint"
     }
     ```
 
-    If the Prettier extension is also active in this workspace, it should be disabled. This is because both will conflict with each other, leading to formatting issues.
-
-    `@july_cm/eslint-config` has already integrated `eslint-plugin-prettier`, ensuring that both can work simultaneously without conflict.
-
+    If the Prettier extension is active in this workspace, disable it — `@july_cm/eslint-config` already integrates `eslint-plugin-prettier` so both work together without conflict.
 
-2. Fix on save
+2. Enable fix on save:
 
     ```json
     {
       "editor.codeActionsOnSave": {
         "source.fixAll.eslint": "explicit"
       },
-      // ESLint does not validate css, json, jsonc by default, needs to be added manually
       "eslint.validate": ["css", "json", "jsonc", "javascript", "javascriptreact", "typescript", "typescriptreact"]
     }
     ```
 
-3. Debug
+3. Debug:
 
-    Open VSCode Command Panel(Ctrl + Shift + P / Cmd + Shift + P) and run:
+    Open the Command Palette (Ctrl + Shift + P / Cmd + Shift + P) and run:
 
     ```
     ESLint: Show Output Channel
     ```
-    Fix errors if they exist.

package/README.zh-CN.md

@@ -6,25 +6,18 @@
 [![NPM Version](https://img.shields.io/npm/v/%40july_cm%2Feslint-config)](https://www.npmjs.com/package/@july_cm/eslint-config)
 [![codecov](https://codecov.io/gh/JxJuly/eslint-config/branch/main/graph/badge.svg?token=T1E32RHZB7)](https://codecov.io/gh/JxJuly/eslint-config)
 
-这是我的通用 ESLint 配置。
+July 的通用 ESLint 配置。
 
-它依赖于 ESLint v9 或更高版本，并且仅兼容扁平化配置。
-
-❌ [传统配置](https://eslint.org/docs/latest/use/configure/configuration-files-deprecated) (legacy: `.eslintrc*`)
-
-✅ [扁平化配置](https://eslint.org/docs/latest/use/configure/configuration-files-new) (new: `eslint.config.js`)
+依赖 ESLint v10 或更高版本，仅兼容[扁平化配置](https://eslint.org/docs/latest/use/configure/configuration-files-new)（`eslint.config.js`）。
 
 ## 功能
 
-- ✅ 开箱即用且轻量的 JavaScript ESLint 配置
-
-- ✅ 开箱即用且轻量的 TypeScript ESLint 配置
-
-- ✅ 开箱即用且轻量的 CSS ESLint 配置
-
-- ✅ 支持 package.json 字段的排序，尤其是 dependencies 等字段
-
-- ✅ 搭配 Prettier 规则的代码风格检查
+- ✅ 开箱即用的 JavaScript ESLint 配置
+- ✅ 开箱即用的 TypeScript ESLint 配置
+- ✅ 开箱即用的 CSS ESLint 配置（支持 Tailwind CSS v4）
+- ✅ 全面的 `package.json` 字段排序（覆盖所有 npm 标准字段 + 子字段排序）
+- ✅ 通过 `eslint-plugin-simple-import-sort` 自动排序 import/export
+- ✅ 集成 Prettier 格式化规则（无需单独安装 Prettier 扩展）
 
 ## 安装
 
@@ -32,104 +25,120 @@
 npm install --save-dev eslint @july_cm/eslint-config
 ```
 
-`@july_cm/eslint-config` 不会为你安装 ESLint，你必须自己安装。
+`@july_cm/eslint-config` 不会为你安装 ESLint，你必须自行安装。
 
 ## 快速开始
 
-扁平化的配置，可以使用指定的编程语言配置或者直接使用推荐配置。
+可以使用单独的语言配置，也可以直接使用 `recommended` 预设。
 
-直接使用 `recommended` 也无需担心 `.ts` 文件被 `javascript` 规则命中，本包内部已经做了规则的隔离，以保证规则和性能的稳定。
+使用 `recommended` 时无需担心 `.ts` 文件被 `javascript` 规则命中——规则已按语言做了内部隔离。
 
 ```javascript
 // eslint.config.js
-const * as config from '@july_cm/eslint-config';
+import * as config from '@july_cm/eslint-config';
 
-// only javascript
+// 仅 JavaScript
 export default config.javascript;
 
-// only typescript
+// 仅 TypeScript
 export default config.typescript;
 
+// 仅 CSS
+export default config.css;
+
+// 仅 package.json 排序
+export default config.packageJson;
+
 /**
- * recommended
+ * recommended（包含以上所有配置）
  * - javascript
  * - typescript
+ * - css
  * - package.json
  */
 export default config.recommended;
 ```
 
-⚠️ 需要注意：若 `package.json` 中的 `type` 字段没有显示设置为 `module`，则文件名需要改为 `eslint.config.mjs`。
+⚠️ 若 `package.json` 中的 `type` 字段未设置为 `"module"`，需要将配置文件名改为 `eslint.config.mjs`。
 
 ## 自定义规则
 
-支持自定义规则或者配置，建议使用 ESLint 官方的函数 `defineConfig` 作为合并函数：
+可以使用 ESLint 的 `defineConfig` 扩展或覆盖规则：
 
 ```javascript
 // eslint.config.js
 import { recommended } from '@july_cm/eslint-config';
-import { defineConfig } from 'eslint/config';
-
-export default defineConfig(recommended, {
-  ignores: ["dist"],
-  rules: {}
-})
+import { defineConfig, globalIgnores } from 'eslint/config';
+
+export default defineConfig(
+  globalIgnores(['dist']),
+  recommended,
+  {
+    rules: {
+      // 你的自定义规则
+    },
+  }
+);
 ```
 
+## 包含的配置
 
-## 中止 `package.json` 键排序
+### JavaScript
 
-排序功能基于 [eslint-plugin-jsonc](https://github.com/ota-meshi/eslint-plugin-jsonc) 和 [prettier](https://github.com/prettier/prettier) 实现。
+- 继承 `@eslint/js` recommended 规则
+- 自动排序 import 和 export
+- Prettier 格式化（单引号、分号、80 字符宽度、ES5 尾逗号）
+- 匹配文件：`**/*.{js,mjs,cjs,jsx}`
 
-```javascript
-[{
-  pathPattern: '^$',
-  order: ['name', 'version', 'author', 'exports', 'types', 'main', 'module', 'scripts', 'dependencies', 'devDependencies'],
-},
-{
-  pathPattern: '^(?:dev|peer|optional|bundled)?[Dd]ependencies$',
-  order: { type: 'asc' },
-},
-{
-  pathPattern: 'exports',
-  order: ['types', 'require', 'import']
-}]
-```
+### TypeScript
+
+- 继承 `@eslint/js` recommended + `typescript-eslint` recommended 规则
+- 强制使用 `type` 导入（`@typescript-eslint/consistent-type-imports`）
+- 自动排序 import 和 export
+- Prettier 格式化
+- 匹配文件：`**/*.{ts,tsx}`
+
+### CSS
+
+- 基于 `@eslint/css`，支持 Tailwind CSS v4 自定义语法
+- Prettier 格式化
+- 匹配文件：`**/*.css`
 
-## 配合 `Visual Studio Code` 使用
+### package.json
+
+- 将所有 npm 标准字段按逻辑分组排序：metadata → environment → entries → scripts → dependencies → publish
+- 子字段排序：`exports`、`repository`、`bugs`、`engines`、`scripts` 等
+- 依赖按字母升序排列
+
+## 配合 Visual Studio Code 使用
 
 1. 安装 [VS Code ESLint 扩展](https://github.com/microsoft/vscode-eslint)。
 
-    检查编辑器中是否有其他插件被设置为默认格式化程序。如果有，需要将它们移除或替换为 ESLint：
+    确保 ESLint 被设置为默认格式化程序：
 
     ```json
     {
-      "editor.defaultFormatter": "dbaeumer.vscode-eslint",
+      "editor.defaultFormatter": "dbaeumer.vscode-eslint"
     }
     ```
 
-    如果 Prettier 扩展在此工作区中也处于活动状态，应该禁用它。这是因为两者会相互冲突，导致格式化问题。
-
-    `@july_cm/eslint-config` 已经集成了 `eslint-plugin-prettier`，确保两者可以同时工作而不会冲突。
-
+    如果 Prettier 扩展在此工作区中处于活动状态，请禁用它——`@july_cm/eslint-config` 已集成 `eslint-plugin-prettier`，两者可以协同工作而不会冲突。
 
-2. 保存时自动修复
+2. 保存时自动修复：
 
     ```json
     {
       "editor.codeActionsOnSave": {
         "source.fixAll.eslint": "explicit"
       },
-      // ESLint 默认不对 css, json, jsonc 进行校验，需要手动添加
       "eslint.validate": ["css", "json", "jsonc", "javascript", "javascriptreact", "typescript", "typescriptreact"]
     }
     ```
 
-3. 调试
+3. 调试：
 
-    打开 VSCode 命令面板（Ctrl + Shift + P / Cmd + Shift + P）并运行：
+    打开命令面板（Ctrl + Shift + P / Cmd + Shift + P）并运行：
 
     ```
     ESLint: Show Output Channel
     ```
-    如果存在错误，请修复它们。

package/dist/index.cjs

@@ -0,0 +1,274 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let eslint_config = require("eslint/config");
+let _eslint_css = require("@eslint/css");
+_eslint_css = __toESM(_eslint_css, 1);
+let eslint_plugin_prettier = require("eslint-plugin-prettier");
+eslint_plugin_prettier = __toESM(eslint_plugin_prettier, 1);
+let tailwind_csstree = require("tailwind-csstree");
+let _eslint_js = require("@eslint/js");
+_eslint_js = __toESM(_eslint_js, 1);
+let eslint_plugin_simple_import_sort = require("eslint-plugin-simple-import-sort");
+eslint_plugin_simple_import_sort = __toESM(eslint_plugin_simple_import_sort, 1);
+let eslint_plugin_prettier_recommended = require("eslint-plugin-prettier/recommended");
+eslint_plugin_prettier_recommended = __toESM(eslint_plugin_prettier_recommended, 1);
+let eslint_plugin_jsonc = require("eslint-plugin-jsonc");
+eslint_plugin_jsonc = __toESM(eslint_plugin_jsonc, 1);
+let typescript_eslint = require("typescript-eslint");
+//#region src/configs/css.ts
+var cssConfig = (0, eslint_config.defineConfig)([{
+	files: ["**/*.css"],
+	plugins: {
+		css: _eslint_css.default,
+		prettier: eslint_plugin_prettier.default
+	},
+	language: "css/css",
+	languageOptions: { customSyntax: tailwind_csstree.tailwind4 },
+	rules: {
+		"css/no-empty-blocks": "error",
+		"prettier/prettier": [
+			"warn",
+			{ tabWidth: 2 },
+			{ usePrettierrc: false }
+		]
+	}
+}]);
+//#endregion
+//#region src/configs/prettier.ts
+/**
+* prettier config 作为具体语言的公共配置
+* prettier 本身可以作为 js、ts、json、css、markdown 等多种语言的格式化工具，这里不做语言限制
+*/
+var prettierConfig = [eslint_plugin_prettier_recommended.default, { rules: { "prettier/prettier": [
+	"warn",
+	{
+		singleQuote: true,
+		printWidth: 80,
+		semi: true,
+		trailingComma: "es5"
+	},
+	{ usePrettierrc: false }
+] } }];
+//#endregion
+//#region src/configs/javascript.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var javascriptConfig = (0, eslint_config.defineConfig)({
+	extends: [_eslint_js.default.configs.recommended, prettierConfig],
+	plugins: { "simple-import-sort": eslint_plugin_simple_import_sort.default },
+	files: ["**/*.{js,mjs,cjs,jsx}"],
+	languageOptions: { ecmaVersion: "latest" },
+	rules: {
+		"simple-import-sort/imports": "error",
+		"simple-import-sort/exports": "error"
+	}
+});
+//#endregion
+//#region src/configs/package-json.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var packageJsonConfig = (0, eslint_config.defineConfig)({
+	extends: [...eslint_plugin_jsonc.default.configs["base"]],
+	files: ["package.json"],
+	rules: { "jsonc/sort-keys": [
+		"warn",
+		{
+			pathPattern: "^$",
+			order: [
+				"name",
+				"version",
+				"private",
+				"description",
+				"keywords",
+				"license",
+				"author",
+				"contributors",
+				"funding",
+				"homepage",
+				"repository",
+				"bugs",
+				"type",
+				"engines",
+				"packageManager",
+				"os",
+				"cpu",
+				"devEngines",
+				"exports",
+				"main",
+				"module",
+				"browser",
+				"types",
+				"bin",
+				"man",
+				"directories",
+				"files",
+				"scripts",
+				"config",
+				"dependencies",
+				"devDependencies",
+				"peerDependencies",
+				"peerDependenciesMeta",
+				"optionalDependencies",
+				"bundleDependencies",
+				"overrides",
+				"publishConfig",
+				"workspaces"
+			]
+		},
+		{
+			pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies(?:Meta)?$",
+			order: { type: "asc" }
+		},
+		{
+			pathPattern: "^(?:overrides|resolutions)$",
+			order: { type: "asc" }
+		},
+		{
+			pathPattern: "^exports(?:\\..+)?$",
+			order: [
+				"types",
+				"import",
+				"require",
+				"default"
+			]
+		},
+		{
+			pathPattern: "^publishConfig$",
+			order: [
+				"registry",
+				"access",
+				"tag"
+			]
+		},
+		{
+			pathPattern: "^repository$",
+			order: [
+				"type",
+				"url",
+				"directory"
+			]
+		},
+		{
+			pathPattern: "^bugs$",
+			order: ["url", "email"]
+		},
+		{
+			pathPattern: "^engines$",
+			order: [
+				"node",
+				"npm",
+				"pnpm"
+			]
+		},
+		{
+			pathPattern: "^(?:devEngines)$",
+			order: [
+				"runtime",
+				"packageManager",
+				"os",
+				"cpu",
+				"libc"
+			]
+		},
+		{
+			pathPattern: "^directories$",
+			order: [
+				"bin",
+				"man",
+				"lib",
+				"doc",
+				"test"
+			]
+		},
+		{
+			pathPattern: "^scripts$",
+			order: [
+				"preinstall",
+				"install",
+				"postinstall",
+				"prepare",
+				"prepack",
+				"postpack",
+				"prepublishOnly",
+				"dev",
+				"build",
+				"start",
+				"test",
+				"lint"
+			]
+		}
+	] }
+});
+//#endregion
+//#region src/configs/typescript.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var typescriptConfig = (0, eslint_config.defineConfig)({
+	extends: [
+		_eslint_js.default.configs.recommended,
+		typescript_eslint.configs.recommended,
+		prettierConfig
+	],
+	plugins: { "simple-import-sort": eslint_plugin_simple_import_sort.default },
+	files: ["**/*.{ts,tsx}"],
+	rules: {
+		"simple-import-sort/imports": "error",
+		"simple-import-sort/exports": "error",
+		"@typescript-eslint/consistent-type-imports": ["error", {
+			disallowTypeAnnotations: true,
+			prefer: "type-imports"
+		}],
+		"@typescript-eslint/no-explicit-any": ["warn"]
+	}
+});
+//#endregion
+//#region src/index.ts
+var recommended = (0, eslint_config.defineConfig)(javascriptConfig, typescriptConfig, packageJsonConfig, cssConfig);
+var javascript = javascriptConfig;
+var typescript = typescriptConfig;
+var packageJson = packageJsonConfig;
+var css = cssConfig;
+var src_default = {
+	recommended,
+	javascript,
+	typescript,
+	packageJson,
+	css
+};
+//#endregion
+exports.css = css;
+exports.default = src_default;
+exports.javascript = javascript;
+exports.packageJson = packageJson;
+exports.recommended = recommended;
+exports.typescript = typescript;

package/dist/index.js

@@ -0,0 +1,237 @@
+import { defineConfig } from "eslint/config";
+import css$1 from "@eslint/css";
+import prettier from "eslint-plugin-prettier";
+import { tailwind4 } from "tailwind-csstree";
+import eslintJs from "@eslint/js";
+import simpleImportSort from "eslint-plugin-simple-import-sort";
+import recommended$1 from "eslint-plugin-prettier/recommended";
+import eslintPluginJsonc from "eslint-plugin-jsonc";
+import { configs } from "typescript-eslint";
+//#region src/configs/css.ts
+var cssConfig = defineConfig([{
+	files: ["**/*.css"],
+	plugins: {
+		css: css$1,
+		prettier
+	},
+	language: "css/css",
+	languageOptions: { customSyntax: tailwind4 },
+	rules: {
+		"css/no-empty-blocks": "error",
+		"prettier/prettier": [
+			"warn",
+			{ tabWidth: 2 },
+			{ usePrettierrc: false }
+		]
+	}
+}]);
+//#endregion
+//#region src/configs/prettier.ts
+/**
+* prettier config 作为具体语言的公共配置
+* prettier 本身可以作为 js、ts、json、css、markdown 等多种语言的格式化工具，这里不做语言限制
+*/
+var prettierConfig = [recommended$1, { rules: { "prettier/prettier": [
+	"warn",
+	{
+		singleQuote: true,
+		printWidth: 80,
+		semi: true,
+		trailingComma: "es5"
+	},
+	{ usePrettierrc: false }
+] } }];
+//#endregion
+//#region src/configs/javascript.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var javascriptConfig = defineConfig({
+	extends: [eslintJs.configs.recommended, prettierConfig],
+	plugins: { "simple-import-sort": simpleImportSort },
+	files: ["**/*.{js,mjs,cjs,jsx}"],
+	languageOptions: { ecmaVersion: "latest" },
+	rules: {
+		"simple-import-sort/imports": "error",
+		"simple-import-sort/exports": "error"
+	}
+});
+//#endregion
+//#region src/configs/package-json.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var packageJsonConfig = defineConfig({
+	extends: [...eslintPluginJsonc.configs["base"]],
+	files: ["package.json"],
+	rules: { "jsonc/sort-keys": [
+		"warn",
+		{
+			pathPattern: "^$",
+			order: [
+				"name",
+				"version",
+				"private",
+				"description",
+				"keywords",
+				"license",
+				"author",
+				"contributors",
+				"funding",
+				"homepage",
+				"repository",
+				"bugs",
+				"type",
+				"engines",
+				"packageManager",
+				"os",
+				"cpu",
+				"devEngines",
+				"exports",
+				"main",
+				"module",
+				"browser",
+				"types",
+				"bin",
+				"man",
+				"directories",
+				"files",
+				"scripts",
+				"config",
+				"dependencies",
+				"devDependencies",
+				"peerDependencies",
+				"peerDependenciesMeta",
+				"optionalDependencies",
+				"bundleDependencies",
+				"overrides",
+				"publishConfig",
+				"workspaces"
+			]
+		},
+		{
+			pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies(?:Meta)?$",
+			order: { type: "asc" }
+		},
+		{
+			pathPattern: "^(?:overrides|resolutions)$",
+			order: { type: "asc" }
+		},
+		{
+			pathPattern: "^exports(?:\\..+)?$",
+			order: [
+				"types",
+				"import",
+				"require",
+				"default"
+			]
+		},
+		{
+			pathPattern: "^publishConfig$",
+			order: [
+				"registry",
+				"access",
+				"tag"
+			]
+		},
+		{
+			pathPattern: "^repository$",
+			order: [
+				"type",
+				"url",
+				"directory"
+			]
+		},
+		{
+			pathPattern: "^bugs$",
+			order: ["url", "email"]
+		},
+		{
+			pathPattern: "^engines$",
+			order: [
+				"node",
+				"npm",
+				"pnpm"
+			]
+		},
+		{
+			pathPattern: "^(?:devEngines)$",
+			order: [
+				"runtime",
+				"packageManager",
+				"os",
+				"cpu",
+				"libc"
+			]
+		},
+		{
+			pathPattern: "^directories$",
+			order: [
+				"bin",
+				"man",
+				"lib",
+				"doc",
+				"test"
+			]
+		},
+		{
+			pathPattern: "^scripts$",
+			order: [
+				"preinstall",
+				"install",
+				"postinstall",
+				"prepare",
+				"prepack",
+				"postpack",
+				"prepublishOnly",
+				"dev",
+				"build",
+				"start",
+				"test",
+				"lint"
+			]
+		}
+	] }
+});
+//#endregion
+//#region src/configs/typescript.ts
+/**
+* defineConfig 会 flat 一层 extends，并且将 files 字段赋值给所有 extends
+* 可以借助这个函数为所有插件添加 files 约束，防止语言之间的污染
+*/
+var typescriptConfig = defineConfig({
+	extends: [
+		eslintJs.configs.recommended,
+		configs.recommended,
+		prettierConfig
+	],
+	plugins: { "simple-import-sort": simpleImportSort },
+	files: ["**/*.{ts,tsx}"],
+	rules: {
+		"simple-import-sort/imports": "error",
+		"simple-import-sort/exports": "error",
+		"@typescript-eslint/consistent-type-imports": ["error", {
+			disallowTypeAnnotations: true,
+			prefer: "type-imports"
+		}],
+		"@typescript-eslint/no-explicit-any": ["warn"]
+	}
+});
+//#endregion
+//#region src/index.ts
+var recommended = defineConfig(javascriptConfig, typescriptConfig, packageJsonConfig, cssConfig);
+var javascript = javascriptConfig;
+var typescript = typescriptConfig;
+var packageJson = packageJsonConfig;
+var css = cssConfig;
+var src_default = {
+	recommended,
+	javascript,
+	typescript,
+	packageJson,
+	css
+};
+//#endregion
+export { css, src_default as default, javascript, packageJson, recommended, typescript };

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "@july_cm/eslint-config",
-  "version": "2.5.0",
+  "version": "2.5.2",
+  "description": "Shared ESLint config for July's projects",
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "prettier",
+    "typescript"
+  ],
+  "license": "MIT",
   "author": "July",
   "homepage": "https://github.com/JxJuly/eslint-config/blob/main/README.md",
   "repository": {
@@ -11,45 +19,51 @@
     "url": "https://github.com/JxJuly/eslint-config/issues"
   },
   "type": "module",
+  "engines": {
+    "node": ">=18.18.0"
+  },
+  "packageManager": "pnpm@10.26.1",
   "exports": {
     ".": {
-      "import": "./lib/index.mjs",
-      "require": "./lib/index.cjs"
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
-  "main": "./lib/index.cjs",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
   "files": [
     "README.md",
-    "lib",
-    "package.json"
+    "dist"
   ],
   "scripts": {
     "build": "vite build",
     "test": "vitest run",
     "test:cov": "vitest run --coverage"
   },
-  "packageManager": "pnpm@10.26.1",
   "dependencies": {
-    "@eslint/css": "^1.0.0",
+    "@eslint/css": "^1.2.0",
     "@eslint/js": "^10.0.1",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-import-resolver-node": "^0.3.9",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-jsonc": "^2.21.0",
+    "eslint-plugin-jsonc": "^3.1.2",
     "eslint-plugin-prettier": "^5.5.4",
-    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-simple-import-sort": "^13.0.0",
     "tailwind-csstree": "^0.3.0",
-    "typescript-eslint": "^8.57.2"
+    "typescript-eslint": "^8.59.2"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.0.15",
-    "eslint": "^10.1.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "eslint": "^10.3.0",
     "typescript": "^5.9.3",
-    "vite": "^7.2.7",
-    "vitest": "^4.0.15"
+    "vite": "^8.0.10",
+    "vitest": "^4.1.5"
   },
-  "optionalPeerDependencies": {
+  "peerDependencies": {
     "eslint": "^10",
     "typescript": "^5"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
   }
 }

package/lib/index.cjs

@@ -1,163 +0,0 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const config = require("eslint/config");
-const css$1 = require("@eslint/css");
-const prettier = require("eslint-plugin-prettier");
-const tailwindCsstree = require("tailwind-csstree");
-const eslintJs = require("@eslint/js");
-const simpleImportSort = require("eslint-plugin-simple-import-sort");
-const recommended$1 = require("eslint-plugin-prettier/recommended");
-const eslintPluginJsonc = require("eslint-plugin-jsonc");
-const typescriptEslint = require("typescript-eslint");
-const cssConfig = config.defineConfig([
-  {
-    files: ["**/*.css"],
-    plugins: { css: css$1, prettier },
-    language: "css/css",
-    languageOptions: {
-      customSyntax: tailwindCsstree.tailwind4
-    },
-    rules: {
-      "css/no-empty-blocks": "error",
-      "prettier/prettier": [
-        "warn",
-        {
-          tabWidth: 2
-        },
-        {
-          usePrettierrc: false
-        }
-      ]
-    }
-  }
-]);
-const prettierConfig = [
-  recommended$1,
-  {
-    rules: {
-      "prettier/prettier": [
-        "warn",
-        {
-          // 优先使用单引号
-          singleQuote: true,
-          printWidth: 110,
-          // 需要分号
-          semi: true,
-          // 仅在 es5 中有效的结构尾随逗号
-          trailingComma: "es5"
-        },
-        {
-          // 不读取 prettier 配置文件，统一走 eslint 配置
-          usePrettierrc: false
-        }
-      ]
-    }
-  }
-];
-const javascriptConfig = config.defineConfig({
-  extends: [eslintJs.configs.recommended, ...prettierConfig],
-  plugins: {
-    "simple-import-sort": simpleImportSort
-  },
-  files: ["**/*.{js,mjs,cjs,jsx}"],
-  languageOptions: {
-    ecmaVersion: "latest"
-  },
-  rules: {
-    "simple-import-sort/imports": "error",
-    "simple-import-sort/exports": "error"
-  },
-  settings: {
-    "import/resolver": {
-      node: true,
-      /**
-       * https://github.com/import-js/eslint-plugin-import/issues/3140
-       * eslint-plugin-import-node 解析器不支持 export 字段，所以不得不使用 eslint-plugin-import-typescript
-       */
-      typescript: true
-    }
-  }
-});
-const packageJsonConfig = config.defineConfig({
-  extends: [...eslintPluginJsonc.configs["flat/prettier"]],
-  files: ["package.json"],
-  rules: {
-    "jsonc/sort-keys": [
-      "warn",
-      {
-        pathPattern: "^$",
-        order: [
-          // basic information
-          "name",
-          "version",
-          "description",
-          "author",
-          "keywords",
-          "homepage",
-          "repository",
-          "bugs",
-          "license",
-          // entries and environment
-          "type",
-          "exports",
-          "types",
-          "main",
-          "bin",
-          "scripts",
-          "packageManager",
-          // dependencies
-          "dependencies",
-          "devDependencies",
-          "peerDependencies",
-          "peerDependenciesMeta",
-          "optionalDependencies",
-          // config
-          "publishConfig"
-        ]
-      },
-      {
-        pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies$",
-        order: { type: "asc" }
-      },
-      {
-        pathPattern: "exports",
-        // Prefer ESM (import) before CommonJS (require)
-        order: ["types", "import", "require"]
-      }
-    ]
-  }
-});
-const typescriptConfig = config.defineConfig({
-  extends: [eslintJs.configs.recommended, typescriptEslint.configs.stylistic, prettierConfig],
-  plugins: {
-    "simple-import-sort": simpleImportSort
-  },
-  files: ["**/*.{ts,tsx}"],
-  rules: {
-    "simple-import-sort/imports": "error",
-    "simple-import-sort/exports": "error",
-    "@typescript-eslint/consistent-type-imports": [
-      "error",
-      { disallowTypeAnnotations: true, prefer: "type-imports" }
-    ],
-    "@typescript-eslint/no-explicit-any": ["warn"]
-  }
-});
-const recommended = config.defineConfig(javascriptConfig, typescriptConfig, packageJsonConfig, cssConfig);
-const javascript = javascriptConfig;
-const typescript = typescriptConfig;
-const packageJson = packageJsonConfig;
-const css = cssConfig;
-const index = {
-  recommended,
-  javascript,
-  typescript,
-  packageJson,
-  css
-};
-exports.css = css;
-exports.default = index;
-exports.javascript = javascript;
-exports.packageJson = packageJson;
-exports.recommended = recommended;
-exports.typescript = typescript;

package/lib/index.mjs

@@ -1,163 +0,0 @@
-import { defineConfig } from "eslint/config";
-import css$1 from "@eslint/css";
-import prettier from "eslint-plugin-prettier";
-import { tailwind4 } from "tailwind-csstree";
-import eslintJs from "@eslint/js";
-import simpleImportSort from "eslint-plugin-simple-import-sort";
-import recommended$1 from "eslint-plugin-prettier/recommended";
-import eslintPluginJsonc from "eslint-plugin-jsonc";
-import { configs } from "typescript-eslint";
-const cssConfig = defineConfig([
-  {
-    files: ["**/*.css"],
-    plugins: { css: css$1, prettier },
-    language: "css/css",
-    languageOptions: {
-      customSyntax: tailwind4
-    },
-    rules: {
-      "css/no-empty-blocks": "error",
-      "prettier/prettier": [
-        "warn",
-        {
-          tabWidth: 2
-        },
-        {
-          usePrettierrc: false
-        }
-      ]
-    }
-  }
-]);
-const prettierConfig = [
-  recommended$1,
-  {
-    rules: {
-      "prettier/prettier": [
-        "warn",
-        {
-          // 优先使用单引号
-          singleQuote: true,
-          printWidth: 110,
-          // 需要分号
-          semi: true,
-          // 仅在 es5 中有效的结构尾随逗号
-          trailingComma: "es5"
-        },
-        {
-          // 不读取 prettier 配置文件，统一走 eslint 配置
-          usePrettierrc: false
-        }
-      ]
-    }
-  }
-];
-const javascriptConfig = defineConfig({
-  extends: [eslintJs.configs.recommended, ...prettierConfig],
-  plugins: {
-    "simple-import-sort": simpleImportSort
-  },
-  files: ["**/*.{js,mjs,cjs,jsx}"],
-  languageOptions: {
-    ecmaVersion: "latest"
-  },
-  rules: {
-    "simple-import-sort/imports": "error",
-    "simple-import-sort/exports": "error"
-  },
-  settings: {
-    "import/resolver": {
-      node: true,
-      /**
-       * https://github.com/import-js/eslint-plugin-import/issues/3140
-       * eslint-plugin-import-node 解析器不支持 export 字段，所以不得不使用 eslint-plugin-import-typescript
-       */
-      typescript: true
-    }
-  }
-});
-const packageJsonConfig = defineConfig({
-  extends: [...eslintPluginJsonc.configs["flat/prettier"]],
-  files: ["package.json"],
-  rules: {
-    "jsonc/sort-keys": [
-      "warn",
-      {
-        pathPattern: "^$",
-        order: [
-          // basic information
-          "name",
-          "version",
-          "description",
-          "author",
-          "keywords",
-          "homepage",
-          "repository",
-          "bugs",
-          "license",
-          // entries and environment
-          "type",
-          "exports",
-          "types",
-          "main",
-          "bin",
-          "scripts",
-          "packageManager",
-          // dependencies
-          "dependencies",
-          "devDependencies",
-          "peerDependencies",
-          "peerDependenciesMeta",
-          "optionalDependencies",
-          // config
-          "publishConfig"
-        ]
-      },
-      {
-        pathPattern: "^(?:dev|peer|optional|bundled)?[Dd]ependencies$",
-        order: { type: "asc" }
-      },
-      {
-        pathPattern: "exports",
-        // Prefer ESM (import) before CommonJS (require)
-        order: ["types", "import", "require"]
-      }
-    ]
-  }
-});
-const typescriptConfig = defineConfig({
-  extends: [eslintJs.configs.recommended, configs.stylistic, prettierConfig],
-  plugins: {
-    "simple-import-sort": simpleImportSort
-  },
-  files: ["**/*.{ts,tsx}"],
-  rules: {
-    "simple-import-sort/imports": "error",
-    "simple-import-sort/exports": "error",
-    "@typescript-eslint/consistent-type-imports": [
-      "error",
-      { disallowTypeAnnotations: true, prefer: "type-imports" }
-    ],
-    "@typescript-eslint/no-explicit-any": ["warn"]
-  }
-});
-const recommended = defineConfig(javascriptConfig, typescriptConfig, packageJsonConfig, cssConfig);
-const javascript = javascriptConfig;
-const typescript = typescriptConfig;
-const packageJson = packageJsonConfig;
-const css = cssConfig;
-const index = {
-  recommended,
-  javascript,
-  typescript,
-  packageJson,
-  css
-};
-export {
-  css,
-  index as default,
-  javascript,
-  packageJson,
-  recommended,
-  typescript
-};