@fast-china/eslint-config 2.1.10 → 2.1.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/CONTRIBUTING.md +1 -1
- package/README.md +3 -3
- package/README.zh.md +3 -3
- package/dist/configs/angular.d.mts +1 -1
- package/dist/configs/angular.mjs.map +1 -1
- package/dist/configs/environment.d.mts +1 -1
- package/dist/configs/environment.mjs.map +1 -1
- package/dist/configs/react.d.mts +1 -1
- package/dist/configs/react.mjs.map +1 -1
- package/dist/configs/typescript.mjs +5 -2
- package/dist/configs/typescript.mjs.map +1 -1
- package/dist/configs/vue.mjs +5 -2
- package/dist/configs/vue.mjs.map +1 -1
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,13 @@ All notable changes to this project are documented in this file.
|
|
|
4
4
|
|
|
5
5
|
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and releases should follow [Semantic Versioning](https://semver.org/).
|
|
6
6
|
|
|
7
|
+
## [2.1.11] - 2026-11-06
|
|
8
|
+
|
|
9
|
+
### Fixed
|
|
10
|
+
|
|
11
|
+
- Allow Promise-returning object-property callbacks typed as `() => void` in TSX and Vue/NVue SFCs via `no-misused-promises.checksVoidReturn.properties: false`; retain the existing JSX attribute exemption and other Promise misuse checks.
|
|
12
|
+
- Clarify that these exemptions do not guarantee that callers handle Promise rejections, and add regression coverage for their file scope.
|
|
13
|
+
|
|
7
14
|
## [2.1.10] - 2026-09-22
|
|
8
15
|
|
|
9
16
|
### Fixed
|
|
@@ -241,6 +248,7 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
|
|
|
241
248
|
- Raised the minimum supported Node.js version to 22.13.0 so the package, local development workflow, and pnpm 11 CI use one consistent runtime baseline.
|
|
242
249
|
- Upgraded `pnpm/action-setup` to v6 so GitHub Actions uses its Node.js 24 runtime without Node.js 20 deprecation warnings.
|
|
243
250
|
|
|
251
|
+
[2.1.11]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.10...v2.1.11
|
|
244
252
|
[2.1.10]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.9...v2.1.10
|
|
245
253
|
[2.1.9]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.8...v2.1.9
|
|
246
254
|
[2.1.8]: https://gitee.com/FastDotnet/fast.eslint.config/compare/v2.1.7...v2.1.8
|
package/CONTRIBUTING.md
CHANGED
|
@@ -30,7 +30,7 @@ Use `pnpm lint:fix` and `pnpm format` for safe mechanical fixes. `pnpm test` fir
|
|
|
30
30
|
5. Preserve the documented JavaScript, TypeScript, and Vue behavior unless a release explicitly changes it; keep historical comparisons in the changelog rather than source comments.
|
|
31
31
|
6. Keep organization-specific dependency restrictions out of this general-purpose package; projects should own those policies.
|
|
32
32
|
7. Explain the purpose, rationale, and important exception or risk immediately above every local rule override.
|
|
33
|
-
8. Document every default rule's severity and valid exceptions; every generated rule entry must have explicitly reviewed incorrect and correct code rather than placeholder comments. Keep repository overrides before third-party preset rules, verify `meta.fixable` before claiming auto-fix support, run `pnpm run docs:rules` after any rule or dependency change, and keep [rules-risk.en](
|
|
33
|
+
8. Document every default rule's severity and valid exceptions; every generated rule entry must have explicitly reviewed incorrect and correct code rather than placeholder comments. Keep repository overrides before third-party preset rules, verify `meta.fixable` before claiming auto-fix support, run `pnpm run docs:rules` after any rule or dependency change, and keep [rules-risk.en](https://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules-risk) plus [rules-risk](https://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules-risk) synchronized.
|
|
34
34
|
9. Never sort a map whose key order has semantics, including conditional objects under `package.json#exports`.
|
|
35
35
|
10. Regenerate `src/typegen.d.ts` whenever ESLint or a bundled plugin changes; confirm new rules and changed option schemas intentionally.
|
|
36
36
|
11. Add or update an integration test for every parser, plugin, option, auto-fix, generated type, or public export change. The root API is intentionally limited to the Vue, UniApp, and framework-neutral project factories, their ready configurations, `defineRules`, and related types.
|
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
Typed ESLint Flat Config for Vue 3, uni-app, TypeScript and Node.js, with optional framework integrations.
|
|
16
16
|
|
|
17
|
-
**[Documentation](
|
|
17
|
+
**[Documentation](https://docs.fastdotnet.cn/en-US/frontend/eslint-config/) · [Official website](https://fastdotnet.com)**
|
|
18
18
|
|
|
19
19
|
## Highlights
|
|
20
20
|
|
|
@@ -101,8 +101,8 @@ Prettier does not run as an ESLint rule. The defaults only load `eslint-config-p
|
|
|
101
101
|
|
|
102
102
|
## Documentation
|
|
103
103
|
|
|
104
|
-
- [Complete rule reference (Chinese)](
|
|
105
|
-
- [Default rules and risk guide](
|
|
104
|
+
- [Complete rule reference (Chinese)](https://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules/)
|
|
105
|
+
- [Default rules and risk guide](https://docs.fastdotnet.cn/en-US/frontend/eslint-config/rules-risk)
|
|
106
106
|
- [Chinese engineering audit](./docs/engineering-audit.zh.md)
|
|
107
107
|
- [Changelog](./CHANGELOG.md)
|
|
108
108
|
|
package/README.zh.md
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
面向 Vue 3、uni-app、TypeScript 与 Node.js 的 ESLint Flat Config,提供按需框架配置与规则类型。
|
|
16
16
|
|
|
17
|
-
**[使用文档](
|
|
17
|
+
**[使用文档](https://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/) · [官方网站](https://fastdotnet.com)**
|
|
18
18
|
|
|
19
19
|
## 特性
|
|
20
20
|
|
|
@@ -101,8 +101,8 @@ Prettier 不作为 ESLint 规则运行。默认配置只加载 `eslint-config-pr
|
|
|
101
101
|
|
|
102
102
|
## 文档
|
|
103
103
|
|
|
104
|
-
- [完整规则手册](
|
|
105
|
-
- [默认规则与风险指南](
|
|
104
|
+
- [完整规则手册](https://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules/)
|
|
105
|
+
- [默认规则与风险指南](https://docs.fastdotnet.cn/zh-CN/frontend/eslint-config/rules-risk)
|
|
106
106
|
- [工程质量审查报告](./docs/engineering-audit.zh.md)
|
|
107
107
|
- [更新日志](./CHANGELOG.md)
|
|
108
108
|
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"angular.mjs","names":[],"sources":["../../src/configs/angular.ts"],"sourcesContent":["import angularPlugin from \"@angular-eslint/eslint-plugin\";\nimport angularTemplatePlugin from \"@angular-eslint/eslint-plugin-template\";\nimport angularTemplateParser from \"@angular-eslint/template-parser\";\nimport { defineConfig } from \"eslint/config\";\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\nimport type { ESLint, Linter } from \"eslint\";\n\n/**\n * Angular TypeScript 源码与 HTML
|
|
1
|
+
{"version":3,"file":"angular.mjs","names":[],"sources":["../../src/configs/angular.ts"],"sourcesContent":["import angularPlugin from \"@angular-eslint/eslint-plugin\";\nimport angularTemplatePlugin from \"@angular-eslint/eslint-plugin-template\";\nimport angularTemplateParser from \"@angular-eslint/template-parser\";\nimport { defineConfig } from \"eslint/config\";\nimport { GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT } from \"../constants\";\nimport { angularRules, angularTemplateAccessibilityRules, angularTemplateRules } from \"../rules\";\nimport type { ESLint, Linter } from \"eslint\";\n\n/**\n * Angular TypeScript 源码与 HTML 模板检查的细分选项\n *\n * @remarks\n * 该对象直接传给 `createAngularConfigs()`。Angular 配置始终包含框架 TypeScript 规则\n * 和外部 `.html` 模板基础规则,本接口只控制成本或迁移影响较高的可选部分。\n *\n * 这些选项不会修改 Angular 编译器、CLI 或模板类型检查配置。调用方应先组合\n * `createBaseConfigs()`,以提供统一的类型感知 TypeScript 配置。\n */\nexport interface AngularConfigOptions {\n\t/**\n\t * 是否使用 Angular 官方 processor,从 TypeScript 文件的\n\t * `@Component({ template: ... })` 元数据中提取内联 HTML 并复用模板规则进行检查。\n\t *\n\t * 关闭后仍会检查 Angular TypeScript 源码和外部 `.html` 模板,只是不再处理组件中的\n\t * 内联模板。大型项目若主要使用外部模板,或 processor 与其他工具发生冲突,可暂时关闭。\n\t * @defaultValue `true`\n\t */\n\tinlineTemplates?: boolean;\n\t/**\n\t * 是否在模板基础正确性规则之外启用 Angular 模板无障碍规则组。\n\t *\n\t * 该规则组检查替代文本、键盘交互、焦点、表单标签和 ARIA 等可访问性问题,适用于\n\t * 外部模板与已提取的内联模板。关闭后仍保留模板语法、严格比较和现代控制流等基础规则。\n\t * 对旧项目而言可能一次产生较多报告,建议在确认迁移计划后再决定是否临时关闭。\n\t * @defaultValue `true`\n\t */\n\ttemplateAccessibility?: boolean;\n}\n\n/**\n * 创建 Angular TypeScript、外部 HTML 模板与内联模板配置。\n *\n * @remarks\n * Angular 支持依赖基础配置先注册 typescript-eslint 解析器;模板由\n * Angular 专用 parser 解析,内联模板通过官方 processor 复用同一套 HTML 规则。\n *\n * @param options - 控制内联模板处理与模板无障碍规则的 Angular 选项。\n * @returns 按 TypeScript 源码、外部模板顺序排列的 ESLint Flat Config 数组。\n */\nexport const createAngularConfigs = ({ inlineTemplates = true, templateAccessibility = true }: AngularConfigOptions = {}): ReturnType<\n\ttypeof defineConfig\n> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: inlineTemplates ? \"@fast-china/angular/typescript-with-inline-templates\" : \"@fast-china/angular/typescript\",\n\t\t\tfiles: [GLOB_ANGULAR_TYPESCRIPT],\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint\": angularPlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\t...(inlineTemplates\n\t\t\t\t? {\n\t\t\t\t\t\tprocessor: angularTemplatePlugin.processors[\"extract-inline-html\"] as Linter.Processor,\n\t\t\t\t\t}\n\t\t\t\t: {}),\n\t\t\trules: angularRules,\n\t\t},\n\t\t{\n\t\t\tname: templateAccessibility ? \"@fast-china/angular/template-accessibility\" : \"@fast-china/angular/template\",\n\t\t\tfiles: [GLOB_ANGULAR_TEMPLATE],\n\t\t\tlanguageOptions: {\n\t\t\t\tparser: angularTemplateParser as unknown as Linter.Parser,\n\t\t\t},\n\t\t\tplugins: {\n\t\t\t\t\"@angular-eslint/template\": angularTemplatePlugin as unknown as ESLint.Plugin,\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...angularTemplateRules,\n\t\t\t\t...(templateAccessibility ? angularTemplateAccessibilityRules : {}),\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;;;;AAiDA,MAAa,wBAAwB,EAAE,kBAAkB,MAAM,wBAAwB,SAA+B,CAAC,MAGtH,aAAa,CACZ;CACC,MAAM,kBAAkB,yDAAyD;CACjF,OAAO,CAAC,uBAAuB;CAC/B,SAAS,EACR,mBAAmB,cACpB;CACA,GAAI,kBACD,EACA,WAAW,sBAAsB,WAAW,uBAC7C,IACC,CAAC;CACJ,OAAO;AACR,GACA;CACC,MAAM,wBAAwB,+CAA+C;CAC7E,OAAO,CAAC,qBAAqB;CAC7B,iBAAiB,EAChB,QAAQ,sBACT;CACA,SAAS,EACR,4BAA4B,sBAC7B;CACA,OAAO;EACN,GAAG;EACH,GAAI,wBAAwB,oCAAoC,CAAC;CAClE;AACD,CACD,CAAC"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"environment.mjs","names":[],"sources":["../../src/configs/environment.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport globals from \"globals\";\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_NODE_TOOLING } from \"../constants\";\nimport type { Linter } from \"eslint\";\n\n/**\n * 应用源码可声明的运行时环境。\n *\n * - `\"browser\"` 仅提供浏览器全局变量。\n * - `\"node\"` 仅提供 Node.js 全局变量。\n * - `\"universal\"` 同时提供浏览器与 Node.js 全局变量。\n */\nexport type RuntimeEnvironment = \"browser\" | \"node\" | \"universal\";\n\n/**\n *
|
|
1
|
+
{"version":3,"file":"environment.mjs","names":[],"sources":["../../src/configs/environment.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport globals from \"globals\";\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_NODE_TOOLING } from \"../constants\";\nimport type { Linter } from \"eslint\";\n\n/**\n * 应用源码可声明的运行时环境。\n *\n * - `\"browser\"` 仅提供浏览器全局变量。\n * - `\"node\"` 仅提供 Node.js 全局变量。\n * - `\"universal\"` 同时提供浏览器与 Node.js 全局变量。\n */\nexport type RuntimeEnvironment = \"browser\" | \"node\" | \"universal\";\n\n/**\n * 运行时全局变量配置片段的选项\n *\n * @remarks\n * 固定项目组合会根据自身处理的语言和框架传入 `files`、`nodeFiles`。该接口仍保持独立,\n * 以便低层组合明确控制环境片段的文件范围。\n *\n * 应用代码与 Node.js 工程文件使用两个独立 Flat Config 片段,避免浏览器源码无条件获得\n * `process`、`Buffer` 等 Node.js 全局变量,也避免配置文件误报这些合法全局变量未定义。\n */\nexport interface EnvironmentConfigOptions {\n\t/**\n\t * 应用代码实际运行的环境,决定 `files` 范围内注入哪组标准全局变量。\n\t *\n\t * `\"browser\"` 只注入浏览器全局变量,`\"node\"` 只注入 Node.js 全局变量,\n\t * `\"universal\"` 同时注入两组。该值不会影响 `nodeFiles` 对应的工程文件;后者始终\n\t * 使用 Node.js 全局变量。\n\t * @defaultValue `\"browser\"`\n\t */\n\tenvironment?: RuntimeEnvironment;\n\t/**\n\t * 需要获得所选运行时全局变量的应用代码 glob 列表。\n\t *\n\t * 项目组合会把自身负责的 JavaScript、TypeScript 和框架文件范围传入这里。数组会\n\t * 复制到生成配置中,不会在函数内部修改调用方传入的值。\n\t * @defaultValue {@link GLOBS_CODE}\n\t */\n\tfiles?: readonly string[];\n\t/**\n\t * 当前启用且允许作为 Node.js 工程文件执行的脚本扩展名 glob 列表。\n\t *\n\t * 每一项都会与内置的配置文件、脚本目录、测试文件和 CLI 文件模式组合为 ESLint\n\t * Flat Config 的 AND 文件条件,避免工程文件模式意外接管组合范围之外的扩展名。\n\t * @defaultValue {@link GLOBS_JAVASCRIPT}\n\t */\n\tnodeFiles?: readonly string[];\n\t/**\n\t * 追加到应用代码环境中的项目级全局变量及其读写权限。\n\t *\n\t * 该记录在标准环境全局变量之后合并,所以同名条目可以覆盖预置权限。它应用于完整\n\t * `files` 范围;其中属于 Node.js 工程文件的子集还会由后续片段追加标准 Node.js 全局\n\t * 变量。值格式遵循 ESLint `Linter.Globals`。\n\t * @defaultValue `{}`\n\t */\n\tglobals?: Linter.Globals;\n}\n\n/**\n * 创建运行时环境相关的 ESLint 配置。\n *\n * @remarks\n * 返回两个相互独立的 Flat Config 片段:第一个为应用源码配置所选环境和项目级全局\n * 变量;第二个仅命中配置、脚本、测试与 CLI 等工程文件,为它们配置 Node.js 全局变量。\n * Node 工具文件的规则覆写由 {@link createNodeToolingConfigs} 在语言规则之后应用。\n *\n * @param options - 运行时环境、目标文件范围与项目级全局变量。\n * @returns 依次包含应用运行时环境和 Node.js 工程文件环境的 Flat Config 数组。\n */\nexport const createEnvironmentConfigs = ({\n\tenvironment = \"browser\",\n\tfiles = GLOBS_CODE,\n\tnodeFiles = GLOBS_JAVASCRIPT,\n\tglobals: projectGlobals = {},\n}: EnvironmentConfigOptions = {}): ReturnType<typeof defineConfig> => {\n\tconst runtimeGlobals = {\n\t\t...(environment !== \"node\" ? globals.browser : {}),\n\t\t...(environment !== \"browser\" ? globals.node : {}),\n\t\t...projectGlobals,\n\t};\n\tconst nodeToolingFiles = GLOBS_NODE_TOOLING.flatMap((nodeGlob) => nodeFiles.map((fileGlob) => [nodeGlob, fileGlob]));\n\n\treturn defineConfig([\n\t\t{\n\t\t\tname: `@fast-china/globals/${environment}`,\n\t\t\tfiles: [...files],\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: runtimeGlobals,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/globals/node-tooling\",\n\t\t\tfiles: nodeToolingFiles,\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: globals.node,\n\t\t\t},\n\t\t},\n\t]);\n};\n\n/**\n * 创建 Node.js 配置、脚本、测试和 CLI 文件的末尾规则覆写。\n *\n * @remarks\n * 该片段必须放在 JavaScript 与 TypeScript 规则之后,确保工具文件可以输出日志并使用\n * CommonJS 兼容加载,而不会放宽浏览器业务源码。\n *\n * @param nodeFiles - 当前已启用的 JavaScript/TypeScript 文件 glob。\n * @returns Node 工具文件规则覆写数组。\n */\nexport const createNodeToolingConfigs = (nodeFiles: readonly string[] = GLOBS_JAVASCRIPT): ReturnType<typeof defineConfig> => {\n\tconst files = GLOBS_NODE_TOOLING.flatMap((nodeGlob) => nodeFiles.map((fileGlob) => [nodeGlob, fileGlob]));\n\n\treturn defineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/node-tooling\",\n\t\t\tfiles,\n\t\t\trules: {\n\t\t\t\t/** Node.js 配置和脚本可能需要加载 CommonJS 包,只在工具文件范围关闭 ESM `import` 限制。 */\n\t\t\t\t\"@typescript-eslint/no-require-imports\": \"off\",\n\t\t\t\t/** 构建、测试和 CLI 脚本允许把执行进度与诊断信息输出到终端。 */\n\t\t\t\t\"no-console\": \"off\",\n\t\t\t},\n\t\t},\n\t]);\n};\n"],"mappings":";;;;;;;;;;;;;;;AAwEA,MAAa,4BAA4B,EACxC,cAAc,WACd,QAAQ,YACR,YAAY,kBACZ,SAAS,iBAAiB,CAAC,MACE,CAAC,MAAuC;CACrE,MAAM,iBAAiB;EACtB,GAAI,gBAAgB,SAAS,QAAQ,UAAU,CAAC;EAChD,GAAI,gBAAgB,YAAY,QAAQ,OAAO,CAAC;EAChD,GAAG;CACJ;CACA,MAAM,mBAAmB,mBAAmB,SAAS,aAAa,UAAU,KAAK,aAAa,CAAC,UAAU,QAAQ,CAAC,CAAC;CAEnH,OAAO,aAAa,CACnB;EACC,MAAM,uBAAuB;EAC7B,OAAO,CAAC,GAAG,KAAK;EAChB,iBAAiB,EAChB,SAAS,eACV;CACD,GACA;EACC,MAAM;EACN,OAAO;EACP,iBAAiB,EAChB,SAAS,QAAQ,KAClB;CACD,CACD,CAAC;AACF;;;;;;;;;;;AAYA,MAAa,4BAA4B,YAA+B,qBAAsD;CAC7H,MAAM,QAAQ,mBAAmB,SAAS,aAAa,UAAU,KAAK,aAAa,CAAC,UAAU,QAAQ,CAAC,CAAC;CAExG,OAAO,aAAa,CACnB;EACC,MAAM;EACN;EACA,OAAO;;GAEN,yCAAyC;;GAEzC,cAAc;EACf;CACD,CACD,CAAC;AACF"}
|
package/dist/configs/react.d.mts
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"react.mjs","names":[],"sources":["../../src/configs/react.ts"],"sourcesContent":["import eslintReact from \"@eslint-react/eslint-plugin\";\nimport { defineConfig } from \"eslint/config\";\nimport eslintPluginReactHooks from \"eslint-plugin-react-hooks\";\nimport { GLOBS_JAVASCRIPT, GLOBS_TYPESCRIPT } from \"../constants\";\nimport { reactRules } from \"../rules\";\nimport type { Linter } from \"eslint\";\n\n/**\n * React 与兼容 JSX
|
|
1
|
+
{"version":3,"file":"react.mjs","names":[],"sources":["../../src/configs/react.ts"],"sourcesContent":["import eslintReact from \"@eslint-react/eslint-plugin\";\nimport { defineConfig } from \"eslint/config\";\nimport eslintPluginReactHooks from \"eslint-plugin-react-hooks\";\nimport { GLOBS_JAVASCRIPT, GLOBS_TYPESCRIPT } from \"../constants\";\nimport { reactRules } from \"../rules\";\nimport type { Linter } from \"eslint\";\n\n/**\n * React 与兼容 JSX 运行时的检测设置\n *\n * @remarks\n * 该对象直接传给 `createReactConfigs()`,用于调整 React 运行时识别设置。配置会在\n * JavaScript/JSX 和 TypeScript/TSX 文件上加载对应的 `@eslint-react` 推荐预置、React\n * 官方 Hooks 推荐预置以及本库 DOM 安全规则。\n *\n * 这些字段只传给 ESLint 插件用于理解项目的 React 语义,不会改变 JSX 编译方式、自动\n * 导入 React、设置打包器别名或安装兼容运行时。\n */\nexport interface ReactConfigOptions {\n\t/**\n\t * 提供 React API 与 JSX 运行时的包入口名称。\n\t *\n\t * 标准 React 项目保持 `\"react\"`;Preact 等兼容运行时可填写自身包名,使\n\t * `@eslint-react` 按正确的导入来源识别组件和 API。该设置不会修改 TypeScript\n\t * `jsxImportSource`、Babel、Vite 或其他构建工具配置,两侧需要由项目自行保持一致。\n\t * @defaultValue `\"react\"`\n\t */\n\timportSource?: string;\n\t/**\n\t * 项目约定用于切换多态组件底层元素或组件类型的属性名。\n\t *\n\t * 例如 `<Button as=\"a\" />` 中的 `as`。插件会据此理解多态组件最终渲染元素的语义,\n\t * 从而提高 DOM 与可访问性相关规则的判断准确度;未采用多态组件时通常无需修改。\n\t * @defaultValue `\"as\"`\n\t */\n\tpolymorphicPropName?: string;\n\t/**\n\t * 供插件选择版本相关行为的 React 版本号或自动检测标记。\n\t *\n\t * `\"detect\"` 会尝试从当前项目依赖解析已安装的 React 版本。monorepo、PnP、兼容运行时\n\t * 或依赖不可见的执行环境若无法可靠检测,可传入明确版本号,例如 `\"19.1.0\"`。\n\t * 该值只影响 lint 规则判断,不会限制或安装 React 依赖版本。\n\t * @defaultValue `\"detect\"`\n\t */\n\tversion?: string;\n}\n\n/**\n * 创建 React、JSX/TSX 与 Hooks 配置。\n *\n * @remarks\n * JavaScript 和 TypeScript 分别继承对应的 @eslint-react 推荐预置;Hooks 使用 React\n * 官方 Flat Recommended。组件、Hooks 即使不返回 JSX 也能在普通 `.js`/`.ts` 中\n * 定义,因此规则覆盖全部已启用脚本扩展名,而不仅是 `.jsx`/`.tsx`。\n *\n * @param options - React 版本、运行时导入来源与多态组件属性设置。\n * @returns React JavaScript、类型感知 TypeScript 与 Hooks Flat Config 数组。\n */\nexport const createReactConfigs = ({ importSource = \"react\", polymorphicPropName = \"as\", version = \"detect\" }: ReactConfigOptions = {}): ReturnType<\n\ttypeof defineConfig\n> => {\n\tconst createConfig = (name: string, files: readonly string[], preset: Linter.Config): ReturnType<typeof defineConfig> =>\n\t\tdefineConfig([\n\t\t\t{\n\t\t\t\tname,\n\t\t\t\tfiles: [...files],\n\t\t\t\textends: [preset, eslintPluginReactHooks.configs.flat.recommended],\n\t\t\t\tsettings: {\n\t\t\t\t\t\"react-x\": {\n\t\t\t\t\t\timportSource,\n\t\t\t\t\t\tpolymorphicPropName,\n\t\t\t\t\t\tversion,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\trules: reactRules,\n\t\t\t},\n\t\t]);\n\n\treturn defineConfig([\n\t\t...createConfig(\"@fast-china/react/javascript\", GLOBS_JAVASCRIPT, eslintReact.configs.recommended),\n\t\t...createConfig(\"@fast-china/react/typescript-type-checked\", GLOBS_TYPESCRIPT, eslintReact.configs[\"recommended-type-checked\"]),\n\t]);\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA0DA,MAAa,sBAAsB,EAAE,eAAe,SAAS,sBAAsB,MAAM,UAAU,aAAiC,CAAC,MAEhI;CACJ,MAAM,gBAAgB,MAAc,OAA0B,WAC7D,aAAa,CACZ;EACC;EACA,OAAO,CAAC,GAAG,KAAK;EAChB,SAAS,CAAC,QAAQ,uBAAuB,QAAQ,KAAK,WAAW;EACjE,UAAU,EACT,WAAW;GACV;GACA;GACA;EACD,EACD;EACA,OAAO;CACR,CACD,CAAC;CAEF,OAAO,aAAa,CACnB,GAAG,aAAa,gCAAgC,kBAAkB,YAAY,QAAQ,WAAW,GACjG,GAAG,aAAa,6CAA6C,kBAAkB,YAAY,QAAQ,2BAA2B,CAC/H,CAAC;AACF"}
|
|
@@ -58,8 +58,11 @@ const createTypeScriptConfigs = (files = GLOBS_TYPESCRIPT, extraFileExtensions =
|
|
|
58
58
|
rules: {
|
|
59
59
|
/** TSX 通常用于 UI 组件,不强制为导出组件补写可由 TypeScript 稳定推断的 JSX 返回类型。 */
|
|
60
60
|
"@typescript-eslint/explicit-module-boundary-types": "off",
|
|
61
|
-
/** TSX
|
|
62
|
-
"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: {
|
|
61
|
+
/** TSX 的 JSX 属性和对象属性允许接收 Promise 返回函数,即使目标类型为 `() => void`;其他 Promise 误用继续检查。 */
|
|
62
|
+
"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: {
|
|
63
|
+
attributes: false,
|
|
64
|
+
properties: false
|
|
65
|
+
} }]
|
|
63
66
|
}
|
|
64
67
|
}]);
|
|
65
68
|
//#endregion
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"typescript.mjs","names":[],"sources":["../../src/configs/typescript.ts"],"sourcesContent":["import eslint from \"@eslint/js\";\nimport { defineConfig } from \"eslint/config\";\nimport tseslint from \"typescript-eslint\";\nimport { GLOBS_TYPESCRIPT, GLOB_TSX } from \"../constants\";\nimport { javascriptRules, typescriptRules, typescriptTypeCheckedRules } from \"../rules\";\nimport type { Linter } from \"eslint\";\n\n/**\n * 返回 typescript-eslint 通用且类型感知的官方预置。\n *\n * @returns ESLint 核心推荐规则与对应的 typescript-eslint 推荐预置。\n */\nexport const getTypeScriptPresetConfigs = (): Linter.Config[] =>\n\t[eslint.configs.recommended, ...tseslint.configs.recommendedTypeChecked] as Linter.Config[];\n\n/**\n * 创建 TypeScript 解析器的 Project Service 选项。\n *\n * @remarks\n * 同一个项目组合中的 TypeScript 与框架文件必须使用完全一致的 `extraFileExtensions`。\n * 否则混合检查文件时,TypeScript Server 会因扩展名集合变化而反复重载整个项目。\n *\n * @param extraFileExtensions - 当前项目组合需要交给 TypeScript Project Service 的额外扩展名。\n * @returns 始终启用 `projectService` 的解析器选项。\n */\nexport const createTypeScriptParserOptions = (extraFileExtensions: readonly string[] = []): Linter.ParserOptions => ({\n\tprojectService: true,\n\t...(extraFileExtensions.length > 0 ? { extraFileExtensions: [...extraFileExtensions] } : {}),\n});\n\n/**\n * 创建 TypeScript 配置。\n *\n * @remarks\n * 始终采用 ESLint 与 typescript-eslint 的 `recommendedTypeChecked` 预置并启动 Project Service,\n * 再由本地规则补充公共模块契约、简洁写法和高价值正确性检查。普通 TypeScript 文件\n * 按 SDK 式模块边界检查;TSX 保留同等类型安全,但允许组件返回类型使用上下文推断。\n * 被检查文件必须属于可发现的 tsconfig。特殊项目可在后置 Flat Config 中覆盖解析器选项。\n *\n * @param files - 应用 TypeScript 配置的 ESLint glob 列表。\n * @param extraFileExtensions - 与同一项目组合中的框架解析器保持一致的额外扩展名。\n * @returns 包含 TypeScript 预置、解析器选项与本地规则的 Flat Config 数组。\n */\nexport const createTypeScriptConfigs = (\n\tfiles: readonly string[] = GLOBS_TYPESCRIPT,\n\textraFileExtensions: readonly string[] = []\n): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/typescript/type-checked\",\n\t\t\tfiles: [...files],\n\t\t\textends: getTypeScriptPresetConfigs(),\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparserOptions: createTypeScriptParserOptions(extraFileExtensions),\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...javascriptRules,\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/typescript/tsx\",\n\t\t\t/** 与调用方传入的 TypeScript 范围取交集,避免独立组合时意外接管范围外的 TSX 文件。 */\n\t\t\tfiles: files.map((file) => [file, GLOB_TSX]),\n\t\t\trules: {\n\t\t\t\t/** TSX 通常用于 UI 组件,不强制为导出组件补写可由 TypeScript 稳定推断的 JSX 返回类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-module-boundary-types\": \"off\",\n\t\t\t\t/** TSX
|
|
1
|
+
{"version":3,"file":"typescript.mjs","names":[],"sources":["../../src/configs/typescript.ts"],"sourcesContent":["import eslint from \"@eslint/js\";\nimport { defineConfig } from \"eslint/config\";\nimport tseslint from \"typescript-eslint\";\nimport { GLOBS_TYPESCRIPT, GLOB_TSX } from \"../constants\";\nimport { javascriptRules, typescriptRules, typescriptTypeCheckedRules } from \"../rules\";\nimport type { Linter } from \"eslint\";\n\n/**\n * 返回 typescript-eslint 通用且类型感知的官方预置。\n *\n * @returns ESLint 核心推荐规则与对应的 typescript-eslint 推荐预置。\n */\nexport const getTypeScriptPresetConfigs = (): Linter.Config[] =>\n\t[eslint.configs.recommended, ...tseslint.configs.recommendedTypeChecked] as Linter.Config[];\n\n/**\n * 创建 TypeScript 解析器的 Project Service 选项。\n *\n * @remarks\n * 同一个项目组合中的 TypeScript 与框架文件必须使用完全一致的 `extraFileExtensions`。\n * 否则混合检查文件时,TypeScript Server 会因扩展名集合变化而反复重载整个项目。\n *\n * @param extraFileExtensions - 当前项目组合需要交给 TypeScript Project Service 的额外扩展名。\n * @returns 始终启用 `projectService` 的解析器选项。\n */\nexport const createTypeScriptParserOptions = (extraFileExtensions: readonly string[] = []): Linter.ParserOptions => ({\n\tprojectService: true,\n\t...(extraFileExtensions.length > 0 ? { extraFileExtensions: [...extraFileExtensions] } : {}),\n});\n\n/**\n * 创建 TypeScript 配置。\n *\n * @remarks\n * 始终采用 ESLint 与 typescript-eslint 的 `recommendedTypeChecked` 预置并启动 Project Service,\n * 再由本地规则补充公共模块契约、简洁写法和高价值正确性检查。普通 TypeScript 文件\n * 按 SDK 式模块边界检查;TSX 保留同等类型安全,但允许组件返回类型使用上下文推断。\n * 被检查文件必须属于可发现的 tsconfig。特殊项目可在后置 Flat Config 中覆盖解析器选项。\n *\n * @param files - 应用 TypeScript 配置的 ESLint glob 列表。\n * @param extraFileExtensions - 与同一项目组合中的框架解析器保持一致的额外扩展名。\n * @returns 包含 TypeScript 预置、解析器选项与本地规则的 Flat Config 数组。\n */\nexport const createTypeScriptConfigs = (\n\tfiles: readonly string[] = GLOBS_TYPESCRIPT,\n\textraFileExtensions: readonly string[] = []\n): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/typescript/type-checked\",\n\t\t\tfiles: [...files],\n\t\t\textends: getTypeScriptPresetConfigs(),\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparserOptions: createTypeScriptParserOptions(extraFileExtensions),\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...javascriptRules,\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/typescript/tsx\",\n\t\t\t/** 与调用方传入的 TypeScript 范围取交集,避免独立组合时意外接管范围外的 TSX 文件。 */\n\t\t\tfiles: files.map((file) => [file, GLOB_TSX]),\n\t\t\trules: {\n\t\t\t\t/** TSX 通常用于 UI 组件,不强制为导出组件补写可由 TypeScript 稳定推断的 JSX 返回类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-module-boundary-types\": \"off\",\n\t\t\t\t/** TSX 的 JSX 属性和对象属性允许接收 Promise 返回函数,即使目标类型为 `() => void`;其他 Promise 误用继续检查。 */\n\t\t\t\t\"@typescript-eslint/no-misused-promises\": [\"error\", { checksVoidReturn: { attributes: false, properties: false } }],\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,mCACZ,CAAC,OAAO,QAAQ,aAAa,GAAG,SAAS,QAAQ,sBAAsB;;;;;;;;;;;AAYxE,MAAa,iCAAiC,sBAAyC,CAAC,OAA6B;CACpH,gBAAgB;CAChB,GAAI,oBAAoB,SAAS,IAAI,EAAE,qBAAqB,CAAC,GAAG,mBAAmB,EAAE,IAAI,CAAC;AAC3F;;;;;;;;;;;;;;AAeA,MAAa,2BACZ,QAA2B,kBAC3B,sBAAyC,CAAC,MAE1C,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,SAAS,2BAA2B;CACpC,iBAAiB;EAChB,aAAa;EACb,eAAe,8BAA8B,mBAAmB;CACjE;CACA,OAAO;EACN,GAAG;EACH,GAAG;EACH,GAAG;CACJ;AACD,GACA;CACC,MAAM;;CAEN,OAAO,MAAM,KAAK,SAAS,CAAC,MAAM,QAAQ,CAAC;CAC3C,OAAO;;EAEN,qDAAqD;;EAErD,0CAA0C,CAAC,SAAS,EAAE,kBAAkB;GAAE,YAAY;GAAO,YAAY;EAAM,EAAE,CAAC;CACnH;AACD,CACD,CAAC"}
|
package/dist/configs/vue.mjs
CHANGED
|
@@ -45,8 +45,11 @@ const createVueConfigs = (files = [GLOB_VUE], extraFileExtensions = [".vue"]) =>
|
|
|
45
45
|
"@typescript-eslint/explicit-function-return-type": "off",
|
|
46
46
|
/** SFC 的导出宏由 Vue 编译器建立契约,不强制补写普通模块边界类型。 */
|
|
47
47
|
"@typescript-eslint/explicit-module-boundary-types": "off",
|
|
48
|
-
/**
|
|
49
|
-
"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: {
|
|
48
|
+
/** SFC 的 JSX 属性和对象属性允许接收 Promise 返回函数,即使目标类型为 `() => void`;其他 Promise 误用继续检查。 */
|
|
49
|
+
"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: {
|
|
50
|
+
attributes: false,
|
|
51
|
+
properties: false
|
|
52
|
+
} }],
|
|
50
53
|
/** `defineEmits` 校验器和框架回调的形参可只声明契约;普通未使用变量和导入仍然报错。 */
|
|
51
54
|
"@typescript-eslint/no-unused-vars": ["error", {
|
|
52
55
|
args: "none",
|
package/dist/configs/vue.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"vue.mjs","names":[],"sources":["../../src/configs/vue.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport eslintPluginVue from \"eslint-plugin-vue\";\nimport tseslint from \"typescript-eslint\";\nimport vueEslintParser from \"vue-eslint-parser\";\nimport { GLOB_JSX, GLOB_TSX, GLOB_VUE } from \"../constants\";\nimport { javascriptRules, typescriptRules, typescriptTypeCheckedRules, vueRules, vueScriptRules } from \"../rules\";\nimport { createTypeScriptParserOptions, getTypeScriptPresetConfigs } from \"./typescript\";\n\n/**\n * 创建 Vue 3 单文件组件配置。\n *\n * @remarks\n * Vue 模板解析器通过 `parserOptions.parser` 委托给 typescript-eslint,统一使用类型感知检查。\n * UniApp 项目可传入 `.nvue` 文件范围及对应扩展名;普通 Vue 项目默认只处理 `.vue`。\n *\n * @param files - 应用 Vue 解析器与规则的单文件组件 glob。\n * @param extraFileExtensions - 与同一项目组合中的 TypeScript 配置保持一致的额外扩展名。\n * @returns 包含 Vue 模板、脚本解析器、推荐预置与本地规则的 Flat Config 数组。\n */\nexport const createVueConfigs = (\n\tfiles: readonly string[] = [GLOB_VUE],\n\textraFileExtensions: readonly string[] = [\".vue\"]\n): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/vue/type-checked\",\n\t\t\tfiles: [...files],\n\t\t\textends: [...getTypeScriptPresetConfigs(), ...eslintPluginVue.configs[\"flat/recommended\"]],\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparser: vueEslintParser,\n\t\t\t\tparserOptions: {\n\t\t\t\t\tparser: tseslint.parser,\n\t\t\t\t\tecmaFeatures: {\n\t\t\t\t\t\tjsx: true,\n\t\t\t\t\t},\n\t\t\t\t\tsourceType: \"module\",\n\t\t\t\t\t...createTypeScriptParserOptions(extraFileExtensions),\n\t\t\t\t},\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t/** Vue SFC 显式接管 TypeScript 预置中的核心规则替换,再由本地策略做最终覆写。 */\n\t\t\t\t...(tseslint.configs.recommendedTypeChecked[1]?.rules ?? {}),\n\t\t\t\t...javascriptRules,\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t\t/** Vue SFC 允许按模板与运行时兜底处理未穷尽的联合类型或枚举。 */\n\t\t\t\t\"@typescript-eslint/switch-exhaustiveness-check\": \"off\",\n\t\t\t\t/** SFC 以模板上下文和快速迭代为主,不强制补写函数返回类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-function-return-type\": \"off\",\n\t\t\t\t/** SFC 的导出宏由 Vue 编译器建立契约,不强制补写普通模块边界类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-module-boundary-types\": \"off\",\n\t\t\t\t/**
|
|
1
|
+
{"version":3,"file":"vue.mjs","names":[],"sources":["../../src/configs/vue.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport eslintPluginVue from \"eslint-plugin-vue\";\nimport tseslint from \"typescript-eslint\";\nimport vueEslintParser from \"vue-eslint-parser\";\nimport { GLOB_JSX, GLOB_TSX, GLOB_VUE } from \"../constants\";\nimport { javascriptRules, typescriptRules, typescriptTypeCheckedRules, vueRules, vueScriptRules } from \"../rules\";\nimport { createTypeScriptParserOptions, getTypeScriptPresetConfigs } from \"./typescript\";\n\n/**\n * 创建 Vue 3 单文件组件配置。\n *\n * @remarks\n * Vue 模板解析器通过 `parserOptions.parser` 委托给 typescript-eslint,统一使用类型感知检查。\n * UniApp 项目可传入 `.nvue` 文件范围及对应扩展名;普通 Vue 项目默认只处理 `.vue`。\n *\n * @param files - 应用 Vue 解析器与规则的单文件组件 glob。\n * @param extraFileExtensions - 与同一项目组合中的 TypeScript 配置保持一致的额外扩展名。\n * @returns 包含 Vue 模板、脚本解析器、推荐预置与本地规则的 Flat Config 数组。\n */\nexport const createVueConfigs = (\n\tfiles: readonly string[] = [GLOB_VUE],\n\textraFileExtensions: readonly string[] = [\".vue\"]\n): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/vue/type-checked\",\n\t\t\tfiles: [...files],\n\t\t\textends: [...getTypeScriptPresetConfigs(), ...eslintPluginVue.configs[\"flat/recommended\"]],\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparser: vueEslintParser,\n\t\t\t\tparserOptions: {\n\t\t\t\t\tparser: tseslint.parser,\n\t\t\t\t\tecmaFeatures: {\n\t\t\t\t\t\tjsx: true,\n\t\t\t\t\t},\n\t\t\t\t\tsourceType: \"module\",\n\t\t\t\t\t...createTypeScriptParserOptions(extraFileExtensions),\n\t\t\t\t},\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t/** Vue SFC 显式接管 TypeScript 预置中的核心规则替换,再由本地策略做最终覆写。 */\n\t\t\t\t...(tseslint.configs.recommendedTypeChecked[1]?.rules ?? {}),\n\t\t\t\t...javascriptRules,\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t\t/** Vue SFC 允许按模板与运行时兜底处理未穷尽的联合类型或枚举。 */\n\t\t\t\t\"@typescript-eslint/switch-exhaustiveness-check\": \"off\",\n\t\t\t\t/** SFC 以模板上下文和快速迭代为主,不强制补写函数返回类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-function-return-type\": \"off\",\n\t\t\t\t/** SFC 的导出宏由 Vue 编译器建立契约,不强制补写普通模块边界类型。 */\n\t\t\t\t\"@typescript-eslint/explicit-module-boundary-types\": \"off\",\n\t\t\t\t/** SFC 的 JSX 属性和对象属性允许接收 Promise 返回函数,即使目标类型为 `() => void`;其他 Promise 误用继续检查。 */\n\t\t\t\t\"@typescript-eslint/no-misused-promises\": [\"error\", { checksVoidReturn: { attributes: false, properties: false } }],\n\t\t\t\t/** `defineEmits` 校验器和框架回调的形参可只声明契约;普通未使用变量和导入仍然报错。 */\n\t\t\t\t\"@typescript-eslint/no-unused-vars\": [\"error\", { args: \"none\", caughtErrors: \"none\", ignoreRestSiblings: true }],\n\t\t\t\t...vueRules,\n\t\t\t},\n\t\t},\n\t]);\n\n/**\n * 创建 Vue JSX 与 TSX 组件脚本语义配置。\n *\n * @remarks\n * `vue-eslint-parser` 会为独立 JSX/TSX 建立 eslint-plugin-vue 所需的组件脚本访问器;\n * TSX 继续委托给 typescript-eslint 并复用项目的 Project Service。这里只加载适用于\n * `defineComponent()`、Options API 与 `setup()` 的脚本规则,不把 kebab-case、模板属性\n * 排序或 `v-text`/`v-html` 等模板节点规则套到 JSX 属性上。\n *\n * @param extraFileExtensions - 与同一项目组合中的 TypeScript 和 SFC 配置保持一致的额外扩展名。\n * @returns 分别处理独立 `.jsx` 与 `.tsx` Vue 组件的 Flat Config 数组。\n */\nexport const createVueJsxConfigs = (extraFileExtensions: readonly string[] = [\".vue\"]): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/vue/jsx\",\n\t\t\tfiles: [GLOB_JSX],\n\t\t\tplugins: {\n\t\t\t\tvue: eslintPluginVue,\n\t\t\t},\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparser: vueEslintParser,\n\t\t\t\tparserOptions: {\n\t\t\t\t\tecmaFeatures: {\n\t\t\t\t\t\tjsx: true,\n\t\t\t\t\t},\n\t\t\t\t\tsourceType: \"module\",\n\t\t\t\t},\n\t\t\t},\n\t\t\trules: vueScriptRules,\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/vue/tsx-type-checked\",\n\t\t\tfiles: [GLOB_TSX],\n\t\t\tplugins: {\n\t\t\t\tvue: eslintPluginVue,\n\t\t\t},\n\t\t\tlanguageOptions: {\n\t\t\t\tecmaVersion: \"latest\",\n\t\t\t\tparser: vueEslintParser,\n\t\t\t\tparserOptions: {\n\t\t\t\t\tparser: tseslint.parser,\n\t\t\t\t\tecmaFeatures: {\n\t\t\t\t\t\tjsx: true,\n\t\t\t\t\t},\n\t\t\t\t\tsourceType: \"module\",\n\t\t\t\t\t...createTypeScriptParserOptions(extraFileExtensions),\n\t\t\t\t},\n\t\t\t},\n\t\t\trules: vueScriptRules,\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAmBA,MAAa,oBACZ,QAA2B,CAAC,QAAQ,GACpC,sBAAyC,CAAC,MAAM,MAEhD,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,SAAS,CAAC,GAAG,2BAA2B,GAAG,GAAG,gBAAgB,QAAQ,mBAAmB;CACzF,iBAAiB;EAChB,aAAa;EACb,QAAQ;EACR,eAAe;GACd,QAAQ,SAAS;GACjB,cAAc,EACb,KAAK,KACN;GACA,YAAY;GACZ,GAAG,8BAA8B,mBAAmB;EACrD;CACD;CACA,OAAO;;EAEN,GAAI,SAAS,QAAQ,uBAAuB,EAAE,EAAE,SAAS,CAAC;EAC1D,GAAG;EACH,GAAG;EACH,GAAG;;EAEH,kDAAkD;;EAElD,oDAAoD;;EAEpD,qDAAqD;;EAErD,0CAA0C,CAAC,SAAS,EAAE,kBAAkB;GAAE,YAAY;GAAO,YAAY;EAAM,EAAE,CAAC;;EAElH,qCAAqC,CAAC,SAAS;GAAE,MAAM;GAAQ,cAAc;GAAQ,oBAAoB;EAAK,CAAC;EAC/G,GAAG;CACJ;AACD,CACD,CAAC;;;;;;;;;;;;;AAcF,MAAa,uBAAuB,sBAAyC,CAAC,MAAM,MACnF,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,QAAQ;CAChB,SAAS,EACR,KAAK,gBACN;CACA,iBAAiB;EAChB,aAAa;EACb,QAAQ;EACR,eAAe;GACd,cAAc,EACb,KAAK,KACN;GACA,YAAY;EACb;CACD;CACA,OAAO;AACR,GACA;CACC,MAAM;CACN,OAAO,CAAC,QAAQ;CAChB,SAAS,EACR,KAAK,gBACN;CACA,iBAAiB;EAChB,aAAa;EACb,QAAQ;EACR,eAAe;GACd,QAAQ,SAAS;GACjB,cAAc,EACb,KAAK,KACN;GACA,YAAY;GACZ,GAAG,8BAA8B,mBAAmB;EACrD;CACD;CACA,OAAO;AACR,CACD,CAAC"}
|
package/dist/index.d.mts
CHANGED
|
@@ -23,7 +23,7 @@ type RejectUnknownRuleNames<Rules extends RuleOptions> = Rules & Record<Exclude<
|
|
|
23
23
|
* ```
|
|
24
24
|
*/
|
|
25
25
|
export declare const defineRules: <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>) => Rules & Linter.RulesRecord;
|
|
26
|
-
/** Vue、UniApp
|
|
26
|
+
/** Vue、UniApp 与框架无关项目完整配置共享的运行环境选项 */
|
|
27
27
|
export interface ProjectConfigOptions {
|
|
28
28
|
/**
|
|
29
29
|
* 应用代码实际运行的环境。配置、脚本、测试和 CLI 文件始终单独获得 Node.js globals。
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * 根入口提供彼此独立的 Vue 3 与 UniApp 完整 ESLint 配置。\n *\n * 配置片段、glob 常量与原始规则分别由 `./configs`、`./constants` 与 `./rules` 子路径提供。\n *\n * @packageDocumentation\n */\nimport { defineConfig } from \"eslint/config\";\nimport { createCommonConfigs } from \"./configs/common\";\nimport { createEnvironmentConfigs, createNodeToolingConfigs } from \"./configs/environment\";\nimport { createGitignoreConfigs, createGlobalIgnores } from \"./configs/ignores\";\nimport { createImportConfigs } from \"./configs/import\";\nimport { createJavaScriptConfigs } from \"./configs/javascript\";\nimport { createJsonConfigs } from \"./configs/json\";\nimport { createPrettierConfigs } from \"./configs/prettier\";\nimport { createRegexpConfigs } from \"./configs/regexp\";\nimport { createPackageJsonSortConfigs } from \"./configs/sort-package\";\nimport { createTsconfigSortConfigs } from \"./configs/sort-tsconfig\";\nimport { createTypeScriptConfigs } from \"./configs/typescript\";\nimport { createUniAppConfigs } from \"./configs/uniapp\";\nimport { createVueConfigs, createVueJsxConfigs } from \"./configs/vue\";\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_TYPESCRIPT, GLOB_NVUE, GLOB_VUE } from \"./constants\";\nimport type { Linter } from \"eslint\";\nimport type { Config } from \"eslint/config\";\nimport type { RuntimeEnvironment } from \"./configs/environment\";\nimport type { RuleOptions } from \"./typegen\";\n\ntype RejectUnknownRuleNames<Rules extends RuleOptions> = Rules & Record<Exclude<keyof Rules, keyof RuleOptions>, never>;\n\n/**\n * 定义带有完整规则名与选项类型检查的 ESLint 规则记录。\n *\n * @remarks\n * 该辅助函数只提供 TypeScript 类型约束,不会克隆、规范化或修改传入对象。规则记录可以\n * 直接放入 Flat Config 的 `rules` 字段,也可以与本包导出的规则记录组合。\n *\n * @typeParam Rules - 基于生成规则 schema 推断出的具体规则记录类型。\n * @param rules - 需要验证的 ESLint 规则记录;未知规则名和无效规则选项会产生类型错误。\n * @returns 原样返回传入的规则记录,并补充 ESLint `RulesRecord` 兼容类型。\n *\n * @example\n * ```ts\n * const rules = defineRules({\n * eqeqeq: [\"error\", \"always\"],\n * });\n * ```\n */\nexport const defineRules = <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>): Rules & Linter.RulesRecord => rules;\n\nexport type { RuleOptions } from \"./typegen\";\n\n/** Vue、UniApp
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * 根入口提供彼此独立的 Vue 3 与 UniApp 完整 ESLint 配置。\n *\n * 配置片段、glob 常量与原始规则分别由 `./configs`、`./constants` 与 `./rules` 子路径提供。\n *\n * @packageDocumentation\n */\nimport { defineConfig } from \"eslint/config\";\nimport { createCommonConfigs } from \"./configs/common\";\nimport { createEnvironmentConfigs, createNodeToolingConfigs } from \"./configs/environment\";\nimport { createGitignoreConfigs, createGlobalIgnores } from \"./configs/ignores\";\nimport { createImportConfigs } from \"./configs/import\";\nimport { createJavaScriptConfigs } from \"./configs/javascript\";\nimport { createJsonConfigs } from \"./configs/json\";\nimport { createPrettierConfigs } from \"./configs/prettier\";\nimport { createRegexpConfigs } from \"./configs/regexp\";\nimport { createPackageJsonSortConfigs } from \"./configs/sort-package\";\nimport { createTsconfigSortConfigs } from \"./configs/sort-tsconfig\";\nimport { createTypeScriptConfigs } from \"./configs/typescript\";\nimport { createUniAppConfigs } from \"./configs/uniapp\";\nimport { createVueConfigs, createVueJsxConfigs } from \"./configs/vue\";\nimport { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_TYPESCRIPT, GLOB_NVUE, GLOB_VUE } from \"./constants\";\nimport type { Linter } from \"eslint\";\nimport type { Config } from \"eslint/config\";\nimport type { RuntimeEnvironment } from \"./configs/environment\";\nimport type { RuleOptions } from \"./typegen\";\n\ntype RejectUnknownRuleNames<Rules extends RuleOptions> = Rules & Record<Exclude<keyof Rules, keyof RuleOptions>, never>;\n\n/**\n * 定义带有完整规则名与选项类型检查的 ESLint 规则记录。\n *\n * @remarks\n * 该辅助函数只提供 TypeScript 类型约束,不会克隆、规范化或修改传入对象。规则记录可以\n * 直接放入 Flat Config 的 `rules` 字段,也可以与本包导出的规则记录组合。\n *\n * @typeParam Rules - 基于生成规则 schema 推断出的具体规则记录类型。\n * @param rules - 需要验证的 ESLint 规则记录;未知规则名和无效规则选项会产生类型错误。\n * @returns 原样返回传入的规则记录,并补充 ESLint `RulesRecord` 兼容类型。\n *\n * @example\n * ```ts\n * const rules = defineRules({\n * eqeqeq: [\"error\", \"always\"],\n * });\n * ```\n */\nexport const defineRules = <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>): Rules & Linter.RulesRecord => rules;\n\nexport type { RuleOptions } from \"./typegen\";\n\n/** Vue、UniApp 与框架无关项目完整配置共享的运行环境选项 */\nexport interface ProjectConfigOptions {\n\t/**\n\t * 应用代码实际运行的环境。配置、脚本、测试和 CLI 文件始终单独获得 Node.js globals。\n\t * @defaultValue `\"browser\"`\n\t */\n\tenvironment?: RuntimeEnvironment;\n}\n\nconst SCRIPT_FILES = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT];\nconst UNIAPP_PROJECT_FILES = [...GLOBS_CODE, GLOB_NVUE];\n\nconst createProjectConfigs = (\n\tenvironment: RuntimeEnvironment,\n\tcodeFiles: readonly string[],\n\textraFileExtensions: readonly string[] = [],\n\tframeworkConfigs: readonly Config[] = []\n): Config[] =>\n\tdefineConfig([\n\t\t...createGlobalIgnores(),\n\t\t...createGitignoreConfigs(),\n\t\t...createEnvironmentConfigs({\n\t\t\tenvironment,\n\t\t\tfiles: codeFiles,\n\t\t\tnodeFiles: SCRIPT_FILES,\n\t\t}),\n\t\t...createCommonConfigs(codeFiles),\n\t\t...createJavaScriptConfigs(),\n\t\t...createImportConfigs(codeFiles),\n\t\t...createRegexpConfigs(codeFiles),\n\t\t...createTypeScriptConfigs(GLOBS_TYPESCRIPT, extraFileExtensions),\n\t\t...createJsonConfigs(),\n\t\t...createPackageJsonSortConfigs(),\n\t\t...createTsconfigSortConfigs(),\n\t\t...frameworkConfigs,\n\t\t...createPrettierConfigs(),\n\t\t...createNodeToolingConfigs(SCRIPT_FILES),\n\t]);\n\n/**\n * 创建不绑定前端框架的 JavaScript 与 TypeScript 完整配置。\n *\n * @remarks\n * TypeScript 模块的导出成员按 SDK 公共 API 检查,内部实现保留类型推断。\n * React、Angular、Markdown 与 Lodash 等能力从 `./configs` 子路径按需组合。\n *\n * @param options - 应用源码的运行环境;默认仅注入浏览器全局变量。\n * @returns 可直接传给 `eslint.config.*` 的 Flat Config 数组。\n */\nexport const createBaseConfigs = ({ environment = \"browser\" }: ProjectConfigOptions = {}): Config[] =>\n\tcreateProjectConfigs(environment, SCRIPT_FILES);\n\n/**\n * 创建处理 `.vue`、Vue JSX 与 Vue TSX,且不注入任何 UniApp 能力的 Vue 3 完整配置。\n *\n * @param options - 应用源码的运行环境;默认仅注入浏览器全局变量。\n * @param overrides - 追加在内置配置之后的项目级 Flat Config 覆写。\n * @returns Vue 3 项目可直接使用的 Flat Config 数组。\n */\nexport const createVueProjectConfigs = ({ environment = \"browser\" }: ProjectConfigOptions = {}, ...overrides: Config[]): Config[] =>\n\tdefineConfig([\n\t\t...createProjectConfigs(environment, GLOBS_CODE, [\".vue\"], [...createVueConfigs([GLOB_VUE], [\".vue\"]), ...createVueJsxConfigs([\".vue\"])]),\n\t\t...overrides,\n\t]);\n\n/**\n * 创建处理 `.vue`、`.nvue`、Vue JSX/TSX、UniApp globals 与应用清单的完整配置。\n *\n * @param options - 应用源码的运行环境;默认仅注入浏览器全局变量。\n * @param overrides - 追加在内置配置之后的项目级 Flat Config 覆写。\n * @returns UniApp 项目可直接使用的 Flat Config 数组。\n */\nexport const createUniAppProjectConfigs = ({ environment = \"browser\" }: ProjectConfigOptions = {}, ...overrides: Config[]): Config[] =>\n\tdefineConfig([\n\t\t...createProjectConfigs(\n\t\t\tenvironment,\n\t\t\tUNIAPP_PROJECT_FILES,\n\t\t\t[\".vue\", \".nvue\"],\n\t\t\t[\n\t\t\t\t...createVueConfigs([GLOB_VUE, GLOB_NVUE], [\".vue\", \".nvue\"]),\n\t\t\t\t...createVueJsxConfigs([\".vue\", \".nvue\"]),\n\t\t\t\t...createUniAppConfigs(UNIAPP_PROJECT_FILES),\n\t\t\t]\n\t\t),\n\t\t...overrides,\n\t]);\n\n/** 不带项目级覆写、可直接导入使用的 Vue 3 默认配置。 */\nexport const vueConfig: Config[] = createVueProjectConfigs();\n\n/** 不带项目级覆写、可直接导入使用的 UniApp 默认配置。 */\nexport const uniAppConfig: Config[] = createUniAppProjectConfigs();\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,MAAa,eAAgD,UAAqE;AAalI,MAAM,eAAe,CAAC,GAAG,kBAAkB,GAAG,gBAAgB;AAC9D,MAAM,uBAAuB,CAAC,GAAG,YAAY,SAAS;AAEtD,MAAM,wBACL,aACA,WACA,sBAAyC,CAAC,GAC1C,mBAAsC,CAAC,MAEvC,aAAa;CACZ,GAAG,oBAAoB;CACvB,GAAG,uBAAuB;CAC1B,GAAG,yBAAyB;EAC3B;EACA,OAAO;EACP,WAAW;CACZ,CAAC;CACD,GAAG,oBAAoB,SAAS;CAChC,GAAG,wBAAwB;CAC3B,GAAG,oBAAoB,SAAS;CAChC,GAAG,oBAAoB,SAAS;CAChC,GAAG,wBAAwB,kBAAkB,mBAAmB;CAChE,GAAG,kBAAkB;CACrB,GAAG,6BAA6B;CAChC,GAAG,0BAA0B;CAC7B,GAAG;CACH,GAAG,sBAAsB;CACzB,GAAG,yBAAyB,YAAY;AACzC,CAAC;;;;;;;;;;;AAYF,MAAa,qBAAqB,EAAE,cAAc,cAAoC,CAAC,MACtF,qBAAqB,aAAa,YAAY;;;;;;;;AAS/C,MAAa,2BAA2B,EAAE,cAAc,cAAoC,CAAC,GAAG,GAAG,cAClG,aAAa,CACZ,GAAG,qBAAqB,aAAa,YAAY,CAAC,MAAM,GAAG,CAAC,GAAG,iBAAiB,CAAC,QAAQ,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,GACxI,GAAG,SACJ,CAAC;;;;;;;;AASF,MAAa,8BAA8B,EAAE,cAAc,cAAoC,CAAC,GAAG,GAAG,cACrG,aAAa,CACZ,GAAG,qBACF,aACA,sBACA,CAAC,QAAQ,OAAO,GAChB;CACC,GAAG,iBAAiB,CAAC,UAAU,SAAS,GAAG,CAAC,QAAQ,OAAO,CAAC;CAC5D,GAAG,oBAAoB,CAAC,QAAQ,OAAO,CAAC;CACxC,GAAG,oBAAoB,oBAAoB;AAC5C,CACD,GACA,GAAG,SACJ,CAAC;;AAGF,MAAa,YAAsB,wBAAwB;;AAG3D,MAAa,eAAyB,2BAA2B"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fast-china/eslint-config",
|
|
3
|
-
"version": "2.1.
|
|
3
|
+
"version": "2.1.11",
|
|
4
4
|
"description": "Practical, typed ESLint Flat Config for Vue 3, UniApp, React, Angular, Vite, TypeScript, JavaScript, and Node.js.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"keywords": [
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"vue3"
|
|
19
19
|
],
|
|
20
20
|
"license": "Apache-2.0",
|
|
21
|
-
"homepage": "
|
|
21
|
+
"homepage": "https://fastdotnet.com",
|
|
22
22
|
"bugs": {
|
|
23
23
|
"url": "https://gitee.com/FastDotnet/fast.eslint.config/issues"
|
|
24
24
|
},
|