@fast-china/eslint-config 2.1.6 → 2.1.8

package/dist/configs/typescript.d.mts

@@ -2,7 +2,7 @@ import { defineConfig } from "eslint/config";
 import { Linter } from "eslint";
 //#region src/configs/typescript.d.ts
 /**
- * 返回 typescript-eslint 严格且类型感知的官方预置。
+ * 返回 typescript-eslint 通用且类型感知的官方预置。
  *
  * @returns ESLint 核心推荐规则与对应的 typescript-eslint 推荐预置。
  */
@@ -11,22 +11,26 @@ export declare const getTypeScriptPresetConfigs: () => Linter.Config[];
  * 创建 TypeScript 解析器的 Project Service 选项。
  *
  * @remarks
- * TypeScript、TSX、Vue 与 NVue 必须使用完全一致的 `extraFileExtensions`。否则混合检查文件时，
- * TypeScript Server 会因扩展名集合变化而反复重载整个项目。
+ * 同一个项目组合中的 TypeScript 与框架文件必须使用完全一致的 `extraFileExtensions`。
+ * 否则混合检查文件时，TypeScript Server 会因扩展名集合变化而反复重载整个项目。
  *
- * @returns 始终启用 `projectService`，并统一声明 Vue 扩展名的解析器选项。
+ * @param extraFileExtensions - 当前项目组合需要交给 TypeScript Project Service 的额外扩展名。
+ * @returns 始终启用 `projectService` 的解析器选项。
  */
-export declare const createTypeScriptParserOptions: () => Linter.ParserOptions;
+export declare const createTypeScriptParserOptions: (extraFileExtensions?: readonly string[]) => Linter.ParserOptions;
 /**
  * 创建 TypeScript 配置。
  *
  * @remarks
- * 始终采用 ESLint 与 typescript-eslint 的 `strictTypeChecked`、`stylisticTypeChecked` 预置并启动 Project Service。
+ * 始终采用 ESLint 与 typescript-eslint 的 `recommendedTypeChecked` 预置并启动 Project Service，
+ * 再由本地规则补充公共模块契约、简洁写法和高价值正确性检查。普通 TypeScript 文件
+ * 按 SDK 式模块边界检查；TSX 保留同等类型安全，但允许组件返回类型使用上下文推断。
  * 被检查文件必须属于可发现的 tsconfig。特殊项目可在后置 Flat Config 中覆盖解析器选项。
  *
  * @param files - 应用 TypeScript 配置的 ESLint glob 列表。
+ * @param extraFileExtensions - 与同一项目组合中的框架解析器保持一致的额外扩展名。
  * @returns 包含 TypeScript 预置、解析器选项与本地规则的 Flat Config 数组。
  */
-export declare const createTypeScriptConfigs: (files?: readonly string[]) => ReturnType<typeof defineConfig>;
+export declare const createTypeScriptConfigs: (files?: readonly string[], extraFileExtensions?: readonly string[]) => ReturnType<typeof defineConfig>;
 //#endregion
 //# sourceMappingURL=typescript.d.mts.map

package/dist/configs/typescript.mjs

@@ -1,4 +1,4 @@
-import { GLOBS_TYPESCRIPT } from "../constants/index.mjs";
+import { GLOBS_TYPESCRIPT, GLOB_TSX } from "../constants/index.mjs";
 import { javascriptRules } from "../rules/javascript.mjs";
 import { typescriptRules, typescriptTypeCheckedRules } from "../rules/typescript.mjs";
 import { defineConfig } from "eslint/config";
@@ -6,54 +6,61 @@ import eslint from "@eslint/js";
 import tseslint from "typescript-eslint";
 //#region src/configs/typescript.ts
 /**
-* 返回 typescript-eslint 严格且类型感知的官方预置。
+* 返回 typescript-eslint 通用且类型感知的官方预置。
 *
 * @returns ESLint 核心推荐规则与对应的 typescript-eslint 推荐预置。
 */
-const getTypeScriptPresetConfigs = () => [
-	eslint.configs.recommended,
-	{
-		name: "@fast-china/typescript/javascript-rules",
-		rules: javascriptRules
-	},
-	...tseslint.configs.strictTypeChecked,
-	...tseslint.configs.stylisticTypeChecked
-];
+const getTypeScriptPresetConfigs = () => [eslint.configs.recommended, ...tseslint.configs.recommendedTypeChecked];
 /**
 * 创建 TypeScript 解析器的 Project Service 选项。
 *
 * @remarks
-* TypeScript、TSX、Vue 与 NVue 必须使用完全一致的 `extraFileExtensions`。否则混合检查文件时，
-* TypeScript Server 会因扩展名集合变化而反复重载整个项目。
+* 同一个项目组合中的 TypeScript 与框架文件必须使用完全一致的 `extraFileExtensions`。
+* 否则混合检查文件时，TypeScript Server 会因扩展名集合变化而反复重载整个项目。
 *
-* @returns 始终启用 `projectService`，并统一声明 Vue 扩展名的解析器选项。
+* @param extraFileExtensions - 当前项目组合需要交给 TypeScript Project Service 的额外扩展名。
+* @returns 始终启用 `projectService` 的解析器选项。
 */
-const createTypeScriptParserOptions = () => ({
+const createTypeScriptParserOptions = (extraFileExtensions = []) => ({
 	projectService: true,
-	extraFileExtensions: [".vue", ".nvue"]
+	...extraFileExtensions.length > 0 ? { extraFileExtensions: [...extraFileExtensions] } : {}
 });
 /**
 * 创建 TypeScript 配置。
 *
 * @remarks
-* 始终采用 ESLint 与 typescript-eslint 的 `strictTypeChecked`、`stylisticTypeChecked` 预置并启动 Project Service。
+* 始终采用 ESLint 与 typescript-eslint 的 `recommendedTypeChecked` 预置并启动 Project Service，
+* 再由本地规则补充公共模块契约、简洁写法和高价值正确性检查。普通 TypeScript 文件
+* 按 SDK 式模块边界检查；TSX 保留同等类型安全，但允许组件返回类型使用上下文推断。
 * 被检查文件必须属于可发现的 tsconfig。特殊项目可在后置 Flat Config 中覆盖解析器选项。
 *
 * @param files - 应用 TypeScript 配置的 ESLint glob 列表。
+* @param extraFileExtensions - 与同一项目组合中的框架解析器保持一致的额外扩展名。
 * @returns 包含 TypeScript 预置、解析器选项与本地规则的 Flat Config 数组。
 */
-const createTypeScriptConfigs = (files = GLOBS_TYPESCRIPT) => defineConfig([{
+const createTypeScriptConfigs = (files = GLOBS_TYPESCRIPT, extraFileExtensions = []) => defineConfig([{
 	name: "@fast-china/typescript/type-checked",
 	files: [...files],
 	extends: getTypeScriptPresetConfigs(),
 	languageOptions: {
 		ecmaVersion: "latest",
-		parserOptions: createTypeScriptParserOptions()
+		parserOptions: createTypeScriptParserOptions(extraFileExtensions)
 	},
 	rules: {
+		...javascriptRules,
 		...typescriptRules,
 		...typescriptTypeCheckedRules
 	}
+}, {
+	name: "@fast-china/typescript/tsx",
+	/** 与调用方传入的 TypeScript 范围取交集，避免独立组合时意外接管范围外的 TSX 文件。 */
+	files: files.map((file) => [file, GLOB_TSX]),
+	rules: {
+		/** TSX 通常用于 UI 组件，不强制为导出组件补写可由 TypeScript 稳定推断的 JSX 返回类型。 */
+		"@typescript-eslint/explicit-module-boundary-types": "off",
+		/** TSX 事件属性由框架接管异步结果，允许把 Promise 返回函数传给 `void` 回调属性；其他误用继续检查。 */
+		"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: { attributes: false } }]
+	}
 }]);
 //#endregion
 export { createTypeScriptConfigs, createTypeScriptParserOptions, getTypeScriptPresetConfigs };

package/dist/configs/typescript.mjs.map

@@ -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 } 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[\n\t\teslint.configs.recommended,\n\t\t{\n\t\t\tname: \"@fast-china/typescript/javascript-rules\",\n\t\t\trules: javascriptRules,\n\t\t},\n\t\t...tseslint.configs.strictTypeChecked,\n\t\t...tseslint.configs.stylisticTypeChecked,\n\t] as Linter.Config[];\n\n/**\n * 创建 TypeScript 解析器的 Project Service 选项。\n *\n * @remarks\n * TypeScript、TSX、Vue 与 NVue 必须使用完全一致的 `extraFileExtensions`。否则混合检查文件时，\n * TypeScript Server 会因扩展名集合变化而反复重载整个项目。\n *\n * @returns 始终启用 `projectService`，并统一声明 Vue 扩展名的解析器选项。\n */\nexport const createTypeScriptParserOptions = (): Linter.ParserOptions => ({\n\tprojectService: true,\n\textraFileExtensions: [\".vue\", \".nvue\"],\n});\n\n/**\n * 创建 TypeScript 配置。\n *\n * @remarks\n * 始终采用 ESLint 与 typescript-eslint 的 `strictTypeChecked`、`stylisticTypeChecked` 预置并启动 Project Service。\n * 被检查文件必须属于可发现的 tsconfig。特殊项目可在后置 Flat Config 中覆盖解析器选项。\n *\n * @param files - 应用 TypeScript 配置的 ESLint glob 列表。\n * @returns 包含 TypeScript 预置、解析器选项与本地规则的 Flat Config 数组。\n */\nexport const createTypeScriptConfigs = (files: readonly string[] = GLOBS_TYPESCRIPT): 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(),\n\t\t\t},\n\t\t\trules: {\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,mCACZ;CACC,OAAO,QAAQ;CACf;EACC,MAAM;EACN,OAAO;CACR;CACA,GAAG,SAAS,QAAQ;CACpB,GAAG,SAAS,QAAQ;AACrB;;;;;;;;;;AAWD,MAAa,uCAA6D;CACzE,gBAAgB;CAChB,qBAAqB,CAAC,QAAQ,OAAO;AACtC;;;;;;;;;;;AAYA,MAAa,2BAA2B,QAA2B,qBAClE,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,SAAS,2BAA2B;CACpC,iBAAiB;EAChB,aAAa;EACb,eAAe,8BAA8B;CAC9C;CACA,OAAO;EACN,GAAG;EACH,GAAG;CACJ;AACD,CACD,CAAC"}
+{"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 事件属性由框架接管异步结果，允许把 Promise 返回函数传给 `void` 回调属性；其他误用继续检查。 */\n\t\t\t\t\"@typescript-eslint/no-misused-promises\": [\"error\", { checksVoidReturn: { attributes: 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,EAAE,YAAY,MAAM,EAAE,CAAC;CAChG;AACD,CACD,CAAC"}

package/dist/configs/uniapp.mjs

@@ -1,5 +1,5 @@
 import { GLOBS_CODE, GLOBS_UNIAPP_JSON, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS } from "../constants/index.mjs";
-import { defineConfig } from "eslint/config";
+import { defineConfig, globalIgnores } from "eslint/config";
 //#region src/configs/uniapp.ts
 /**
 * 创建 UniApp 跨端运行时与项目清单适配。
@@ -12,18 +12,24 @@ import { defineConfig } from "eslint/config";
 * @param files - 应用 UniApp 公共全局变量的代码文件 glob。
 * @returns UniApp globals 与 JSON 注释兼容配置。
 */
-const createUniAppConfigs = (files = GLOBS_CODE) => defineConfig([{
-	name: "@fast-china/uniapp/globals",
-	files: [...files],
-	languageOptions: { globals: {
-		...UNIAPP_GLOBALS,
-		...UNIAPP_CONDITIONAL_GLOBALS
-	} }
-}, {
-	name: "@fast-china/uniapp/json",
-	files: [...GLOBS_UNIAPP_JSON],
-	rules: { "jsonc/no-comments": "off" }
-}]);
+const createUniAppConfigs = (files = GLOBS_CODE) => defineConfig([
+	globalIgnores(["**/unpackage/**"], "@fast-china/uniapp/ignores"),
+	{
+		name: "@fast-china/uniapp/globals",
+		files: [...files],
+		languageOptions: { globals: {
+			...UNIAPP_GLOBALS,
+			...UNIAPP_CONDITIONAL_GLOBALS
+		} }
+	},
+	{
+		name: "@fast-china/uniapp/json",
+		files: [...GLOBS_UNIAPP_JSON],
+		rules: { 
+		/** UniApp 的 `pages.json` 和 `manifest.json` 使用允许注释的 JSONC 方言。 */
+"jsonc/no-comments": "off" }
+	}
+]);
 //#endregion
 export { createUniAppConfigs };
 

package/dist/configs/uniapp.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"uniapp.mjs","names":[],"sources":["../../src/configs/uniapp.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport { GLOBS_CODE, GLOBS_UNIAPP_JSON, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS } from \"../constants\";\n\n/**\n * 创建 UniApp 跨端运行时与项目清单适配。\n *\n * @remarks\n * 除跨端公共 API 外，也声明条件编译分支常用的 `wx`、`plus`、`my`、`tt` 等平台对象。\n * ESLint 不执行 UniApp 预处理器，因此这些对象在整个 UniApp 文件内可见；该配置不会验证\n * 对象是否位于正确的 `#ifdef` 分支中。`.nvue` 的解析由 Vue 配置负责。\n *\n * @param files - 应用 UniApp 公共全局变量的代码文件 glob。\n * @returns UniApp globals 与 JSON 注释兼容配置。\n */\nexport const createUniAppConfigs = (files: readonly string[] = GLOBS_CODE): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/uniapp/globals\",\n\t\t\tfiles: [...files],\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: {\n\t\t\t\t\t...UNIAPP_GLOBALS,\n\t\t\t\t\t...UNIAPP_CONDITIONAL_GLOBALS,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/uniapp/json\",\n\t\t\tfiles: [...GLOBS_UNIAPP_JSON],\n\t\t\trules: {\n\t\t\t\t// UniApp 的 pages.json 和 manifest.json 使用允许注释的 JSONC 方言。\n\t\t\t\t\"jsonc/no-comments\": \"off\",\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,iBAAiB,EAChB,SAAS;EACR,GAAG;EACH,GAAG;CACJ,EACD;AACD,GACA;CACC,MAAM;CACN,OAAO,CAAC,GAAG,iBAAiB;CAC5B,OAAO,EAEN,qBAAqB,MACtB;AACD,CACD,CAAC"}
+{"version":3,"file":"uniapp.mjs","names":[],"sources":["../../src/configs/uniapp.ts"],"sourcesContent":["import { defineConfig, globalIgnores } from \"eslint/config\";\nimport { GLOBS_CODE, GLOBS_UNIAPP_JSON, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS } from \"../constants\";\n\n/**\n * 创建 UniApp 跨端运行时与项目清单适配。\n *\n * @remarks\n * 除跨端公共 API 外，也声明条件编译分支常用的 `wx`、`plus`、`my`、`tt` 等平台对象。\n * ESLint 不执行 UniApp 预处理器，因此这些对象在整个 UniApp 文件内可见；该配置不会验证\n * 对象是否位于正确的 `#ifdef` 分支中。`.nvue` 的解析由 Vue 配置负责。\n *\n * @param files - 应用 UniApp 公共全局变量的代码文件 glob。\n * @returns UniApp globals 与 JSON 注释兼容配置。\n */\nexport const createUniAppConfigs = (files: readonly string[] = GLOBS_CODE): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\tglobalIgnores([\"**/unpackage/**\"], \"@fast-china/uniapp/ignores\"),\n\t\t{\n\t\t\tname: \"@fast-china/uniapp/globals\",\n\t\t\tfiles: [...files],\n\t\t\tlanguageOptions: {\n\t\t\t\tglobals: {\n\t\t\t\t\t...UNIAPP_GLOBALS,\n\t\t\t\t\t...UNIAPP_CONDITIONAL_GLOBALS,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: \"@fast-china/uniapp/json\",\n\t\t\tfiles: [...GLOBS_UNIAPP_JSON],\n\t\t\trules: {\n\t\t\t\t/** UniApp 的 `pages.json` 和 `manifest.json` 使用允许注释的 JSONC 方言。 */\n\t\t\t\t\"jsonc/no-comments\": \"off\",\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;AAcA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa;CACZ,cAAc,CAAC,iBAAiB,GAAG,4BAA4B;CAC/D;EACC,MAAM;EACN,OAAO,CAAC,GAAG,KAAK;EAChB,iBAAiB,EAChB,SAAS;GACR,GAAG;GACH,GAAG;EACJ,EACD;CACD;CACA;EACC,MAAM;EACN,OAAO,CAAC,GAAG,iBAAiB;EAC5B,OAAO;;AAEN,qBAAqB,MACtB;CACD;AACD,CAAC"}

package/dist/configs/vue.d.mts

@@ -4,11 +4,26 @@ import { defineConfig } from "eslint/config";
  * 创建 Vue 3 单文件组件配置。
  *
  * @remarks
- * 本包只处理 Vue 3，并默认同时接管 UniApp 原生渲染页面使用的 `.nvue`。Vue 模板解析器
- * 通过 `parserOptions.parser` 委托给 typescript-eslint，统一使用类型感知检查。
+ * Vue 模板解析器通过 `parserOptions.parser` 委托给 typescript-eslint，统一使用类型感知检查。
+ * UniApp 项目可传入 `.nvue` 文件范围及对应扩展名；普通 Vue 项目默认只处理 `.vue`。
  *
+ * @param files - 应用 Vue 解析器与规则的单文件组件 glob。
+ * @param extraFileExtensions - 与同一项目组合中的 TypeScript 配置保持一致的额外扩展名。
  * @returns 包含 Vue 模板、脚本解析器、推荐预置与本地规则的 Flat Config 数组。
  */
-export declare const createVueConfigs: () => ReturnType<typeof defineConfig>;
+export declare const createVueConfigs: (files?: readonly string[], extraFileExtensions?: readonly string[]) => ReturnType<typeof defineConfig>;
+/**
+ * 创建 Vue JSX 与 TSX 组件脚本语义配置。
+ *
+ * @remarks
+ * `vue-eslint-parser` 会为独立 JSX/TSX 建立 eslint-plugin-vue 所需的组件脚本访问器；
+ * TSX 继续委托给 typescript-eslint 并复用项目的 Project Service。这里只加载适用于
+ * `defineComponent()`、Options API 与 `setup()` 的脚本规则，不把 kebab-case、模板属性
+ * 排序或 `v-text`/`v-html` 等模板节点规则套到 JSX 属性上。
+ *
+ * @param extraFileExtensions - 与同一项目组合中的 TypeScript 和 SFC 配置保持一致的额外扩展名。
+ * @returns 分别处理独立 `.jsx` 与 `.tsx` Vue 组件的 Flat Config 数组。
+ */
+export declare const createVueJsxConfigs: (extraFileExtensions?: readonly string[]) => ReturnType<typeof defineConfig>;
 //#endregion
 //# sourceMappingURL=vue.d.mts.map

package/dist/configs/vue.mjs

@@ -1,6 +1,7 @@
-import { GLOB_NVUE, GLOB_VUE } from "../constants/index.mjs";
+import { GLOB_JSX, GLOB_TSX, GLOB_VUE } from "../constants/index.mjs";
+import { javascriptRules } from "../rules/javascript.mjs";
 import { typescriptRules, typescriptTypeCheckedRules } from "../rules/typescript.mjs";
-import { vueRules } from "../rules/vue.mjs";
+import { vueRules, vueScriptRules } from "../rules/vue.mjs";
 import { createTypeScriptParserOptions, getTypeScriptPresetConfigs } from "./typescript.mjs";
 import { defineConfig } from "eslint/config";
 import tseslint from "typescript-eslint";
@@ -11,14 +12,16 @@ import vueEslintParser from "vue-eslint-parser";
 * 创建 Vue 3 单文件组件配置。
 *
 * @remarks
-* 本包只处理 Vue 3，并默认同时接管 UniApp 原生渲染页面使用的 `.nvue`。Vue 模板解析器
-* 通过 `parserOptions.parser` 委托给 typescript-eslint，统一使用类型感知检查。
+* Vue 模板解析器通过 `parserOptions.parser` 委托给 typescript-eslint，统一使用类型感知检查。
+* UniApp 项目可传入 `.nvue` 文件范围及对应扩展名；普通 Vue 项目默认只处理 `.vue`。
 *
+* @param files - 应用 Vue 解析器与规则的单文件组件 glob。
+* @param extraFileExtensions - 与同一项目组合中的 TypeScript 配置保持一致的额外扩展名。
 * @returns 包含 Vue 模板、脚本解析器、推荐预置与本地规则的 Flat Config 数组。
 */
-const createVueConfigs = () => defineConfig([{
+const createVueConfigs = (files = [GLOB_VUE], extraFileExtensions = [".vue"]) => defineConfig([{
 	name: "@fast-china/vue/type-checked",
-	files: [GLOB_VUE, GLOB_NVUE],
+	files: [...files],
 	extends: [...getTypeScriptPresetConfigs(), ...eslintPluginVue.configs["flat/recommended"]],
 	languageOptions: {
 		ecmaVersion: "latest",
@@ -27,15 +30,22 @@ const createVueConfigs = () => defineConfig([{
 			parser: tseslint.parser,
 			ecmaFeatures: { jsx: true },
 			sourceType: "module",
-			...createTypeScriptParserOptions()
+			...createTypeScriptParserOptions(extraFileExtensions)
 		}
 	},
 	rules: {
-		...tseslint.configs.strictTypeChecked[1]?.rules ?? {},
+		/** Vue SFC 显式接管 TypeScript 预置中的核心规则替换，再由本地策略做最终覆写。 */
+		...tseslint.configs.recommendedTypeChecked[1]?.rules ?? {},
+		...javascriptRules,
 		...typescriptRules,
 		...typescriptTypeCheckedRules,
+		/** SFC 以模板上下文和快速迭代为主，不强制补写函数返回类型。 */
 		"@typescript-eslint/explicit-function-return-type": "off",
+		/** SFC 的导出宏由 Vue 编译器建立契约，不强制补写普通模块边界类型。 */
 		"@typescript-eslint/explicit-module-boundary-types": "off",
+		/** Vue 模板事件由框架接管异步结果，允许 Promise 返回的事件处理函数；其他 Promise 误用继续检查。 */
+		"@typescript-eslint/no-misused-promises": ["error", { checksVoidReturn: { attributes: false } }],
+		/** `defineEmits` 校验器和框架回调的形参可只声明契约；普通未使用变量和导入仍然报错。 */
 		"@typescript-eslint/no-unused-vars": ["error", {
 			args: "none",
 			caughtErrors: "none",
@@ -44,7 +54,48 @@ const createVueConfigs = () => defineConfig([{
 		...vueRules
 	}
 }]);
+/**
+* 创建 Vue JSX 与 TSX 组件脚本语义配置。
+*
+* @remarks
+* `vue-eslint-parser` 会为独立 JSX/TSX 建立 eslint-plugin-vue 所需的组件脚本访问器；
+* TSX 继续委托给 typescript-eslint 并复用项目的 Project Service。这里只加载适用于
+* `defineComponent()`、Options API 与 `setup()` 的脚本规则，不把 kebab-case、模板属性
+* 排序或 `v-text`/`v-html` 等模板节点规则套到 JSX 属性上。
+*
+* @param extraFileExtensions - 与同一项目组合中的 TypeScript 和 SFC 配置保持一致的额外扩展名。
+* @returns 分别处理独立 `.jsx` 与 `.tsx` Vue 组件的 Flat Config 数组。
+*/
+const createVueJsxConfigs = (extraFileExtensions = [".vue"]) => defineConfig([{
+	name: "@fast-china/vue/jsx",
+	files: [GLOB_JSX],
+	plugins: { vue: eslintPluginVue },
+	languageOptions: {
+		ecmaVersion: "latest",
+		parser: vueEslintParser,
+		parserOptions: {
+			ecmaFeatures: { jsx: true },
+			sourceType: "module"
+		}
+	},
+	rules: vueScriptRules
+}, {
+	name: "@fast-china/vue/tsx-type-checked",
+	files: [GLOB_TSX],
+	plugins: { vue: eslintPluginVue },
+	languageOptions: {
+		ecmaVersion: "latest",
+		parser: vueEslintParser,
+		parserOptions: {
+			parser: tseslint.parser,
+			ecmaFeatures: { jsx: true },
+			sourceType: "module",
+			...createTypeScriptParserOptions(extraFileExtensions)
+		}
+	},
+	rules: vueScriptRules
+}]);
 //#endregion
-export { createVueConfigs };
+export { createVueConfigs, createVueJsxConfigs };
 
 //# sourceMappingURL=vue.mjs.map

package/dist/configs/vue.mjs.map

@@ -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_NVUE, GLOB_VUE } from \"../constants\";\nimport { typescriptRules, typescriptTypeCheckedRules, vueRules } from \"../rules\";\nimport { createTypeScriptParserOptions, getTypeScriptPresetConfigs } from \"./typescript\";\n\n/**\n * 创建 Vue 3 单文件组件配置。\n *\n * @remarks\n * 本包只处理 Vue 3，并默认同时接管 UniApp 原生渲染页面使用的 `.nvue`。Vue 模板解析器\n * 通过 `parserOptions.parser` 委托给 typescript-eslint，统一使用类型感知检查。\n *\n * @returns 包含 Vue 模板、脚本解析器、推荐预置与本地规则的 Flat Config 数组。\n */\nexport const createVueConfigs = (): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/vue/type-checked\",\n\t\t\tfiles: [GLOB_VUE, GLOB_NVUE],\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(),\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.strictTypeChecked[1]?.rules ?? {}),\n\t\t\t\t...typescriptRules,\n\t\t\t\t...typescriptTypeCheckedRules,\n\t\t\t\t// SFC 以模板上下文和快速迭代为主，不强制补写函数返回类型或模块边界类型。\n\t\t\t\t\"@typescript-eslint/explicit-function-return-type\": \"off\",\n\t\t\t\t\"@typescript-eslint/explicit-module-boundary-types\": \"off\",\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"],"mappings":";;;;;;;;;;;;;;;;;;AAiBA,MAAa,yBACZ,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,UAAU,SAAS;CAC3B,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;EAClC;CACD;CACA,OAAO;EAEN,GAAI,SAAS,QAAQ,kBAAkB,EAAE,EAAE,SAAS,CAAC;EACrD,GAAG;EACH,GAAG;EAEH,oDAAoD;EACpD,qDAAqD;EAErD,qCAAqC,CAAC,SAAS;GAAE,MAAM;GAAQ,cAAc;GAAQ,oBAAoB;EAAK,CAAC;EAC/G,GAAG;CACJ;AACD,CACD,CAAC"}
+{"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/** 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/** Vue 模板事件由框架接管异步结果，允许 Promise 返回的事件处理函数；其他 Promise 误用继续检查。 */\n\t\t\t\t\"@typescript-eslint/no-misused-promises\": [\"error\", { checksVoidReturn: { attributes: 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,oDAAoD;;EAEpD,qDAAqD;;EAErD,0CAA0C,CAAC,SAAS,EAAE,kBAAkB,EAAE,YAAY,MAAM,EAAE,CAAC;;EAE/F,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/constants/index.d.mts

@@ -12,6 +12,10 @@
 export declare const GLOBS_JAVASCRIPT: readonly ["**/*.{js,cjs,mjs,jsx}"];
 /** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */
 export declare const GLOBS_TYPESCRIPT: readonly ["**/*.{ts,cts,mts,tsx}"];
+/** 独立 JSX 文件；用于为 Vue 等 JSX 运行时叠加组件脚本语义规则。 */
+export declare const GLOB_JSX = "**/*.jsx";
+/** 独立 TSX 文件；用于在完整 TypeScript 范围内叠加 UI 组件专项规则。 */
+export declare const GLOB_TSX = "**/*.tsx";
 /** Vue 3 单文件组件。 */
 export declare const GLOB_VUE = "**/*.vue";
 /** UniApp 原生渲染页面使用的 Vue 单文件组件。 */

package/dist/constants/index.mjs

@@ -12,6 +12,10 @@
 const GLOBS_JAVASCRIPT = ["**/*.{js,cjs,mjs,jsx}"];
 /** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */
 const GLOBS_TYPESCRIPT = ["**/*.{ts,cts,mts,tsx}"];
+/** 独立 JSX 文件；用于为 Vue 等 JSX 运行时叠加组件脚本语义规则。 */
+const GLOB_JSX = "**/*.jsx";
+/** 独立 TSX 文件；用于在完整 TypeScript 范围内叠加 UI 组件专项规则。 */
+const GLOB_TSX = "**/*.tsx";
 /** Vue 3 单文件组件。 */
 const GLOB_VUE = "**/*.vue";
 /** UniApp 原生渲染页面使用的 Vue 单文件组件。 */
@@ -89,6 +93,6 @@ const GLOBS_LOCKFILES = [
 	"**/deno.lock"
 ];
 //#endregion
-export { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_LOCKFILES, GLOBS_NODE_TOOLING, GLOBS_TSCONFIG, GLOBS_TYPESCRIPT, GLOBS_UNIAPP_JSON, GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_MARKDOWN, GLOB_NVUE, GLOB_VUE, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS };
+export { GLOBS_CODE, GLOBS_JAVASCRIPT, GLOBS_LOCKFILES, GLOBS_NODE_TOOLING, GLOBS_TSCONFIG, GLOBS_TYPESCRIPT, GLOBS_UNIAPP_JSON, GLOB_ANGULAR_TEMPLATE, GLOB_ANGULAR_TYPESCRIPT, GLOB_JSON, GLOB_JSON5, GLOB_JSONC, GLOB_JSX, GLOB_MARKDOWN, GLOB_NVUE, GLOB_TSX, GLOB_VUE, UNIAPP_CONDITIONAL_GLOBALS, UNIAPP_GLOBALS };
 
 //# sourceMappingURL=index.mjs.map

package/dist/constants/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["/**\n * `@fast-china/eslint-config/constants` 公开的文件匹配常量。\n *\n * @remarks\n * 所有模式均使用 ESLint Flat Config 的 glob 语义，可直接用于配置的 `files` 或\n * `ignores` 字段。数组常量使用只读元组类型，调用方组合时应复制而非原地修改。\n *\n * @packageDocumentation\n */\n\n/** JavaScript 与 JSX 文件；扩展名列表与 Node.js ESM/CJS 约定保持一致。 */\nexport const GLOBS_JAVASCRIPT = [\"**/*.{js,cjs,mjs,jsx}\"] as const;\n\n/** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */\nexport const GLOBS_TYPESCRIPT = [\"**/*.{ts,cts,mts,tsx}\"] as const;\n\n/** Vue 3 单文件组件。 */\nexport const GLOB_VUE = \"**/*.vue\";\n\n/** UniApp 原生渲染页面使用的 Vue 单文件组件。 */\nexport const GLOB_NVUE = \"**/*.nvue\";\n\n/** Angular 组件、指令、服务等框架源码；Angular CLI 项目以 `.ts` 为标准源码扩展名。 */\nexport const GLOB_ANGULAR_TYPESCRIPT = \"**/*.ts\";\n\n/** Angular 外部模板；内联模板由 Angular 处理器提取后复用同一模板配置。 */\nexport const GLOB_ANGULAR_TEMPLATE = \"**/*.html\";\n\n/** 严格 JSON 文件。 */\nexport const GLOB_JSON = \"**/*.json\";\n/** 允许注释与尾随逗号的 JSONC 文件。 */\nexport const GLOB_JSONC = \"**/*.jsonc\";\n/** 使用 JSON5 语法的配置文件。 */\nexport const GLOB_JSON5 = \"**/*.json5\";\n\n/** Markdown 文档。 */\nexport const GLOB_MARKDOWN = \"**/*.md\";\n\n/** UniApp 项目允许使用注释的应用清单和页面路由配置。 */\nexport const GLOBS_UNIAPP_JSON = [\"**/manifest.json\", \"**/pages.json\"] as const;\n\n/** UniApp 跨端运行时提供的公共全局变量。 */\nexport const UNIAPP_GLOBALS = {\n\tgetApp: \"readonly\",\n\tgetCurrentPages: \"readonly\",\n\tgetCurrentSubNVue: \"readonly\",\n\tuni: \"readonly\",\n\tuniCloud: \"readonly\",\n} as const;\n\n/**\n * UniApp 条件编译分支中可能由目标平台注入的全局变量。\n *\n * @remarks\n * ESLint 不执行 `#ifdef`/`#endif` 预处理，因此启用 UniApp 后统一声明这些对象。它们只解决\n * 静态 `no-undef`，不会验证当前发行目标是否真的提供对应 API。\n */\nexport const UNIAPP_CONDITIONAL_GLOBALS = {\n\tdd: \"readonly\",\n\tjd: \"readonly\",\n\tks: \"readonly\",\n\tmy: \"readonly\",\n\tplus: \"readonly\",\n\tqh: \"readonly\",\n\tqq: \"readonly\",\n\tswan: \"readonly\",\n\ttt: \"readonly\",\n\tweex: \"readonly\",\n\twx: \"readonly\",\n} as const;\n\n/** 默认由 JavaScript、TypeScript 和 Vue 规则处理的全部代码文件。 */\nexport const GLOBS_CODE = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT, GLOB_VUE] as const;\n\n/**\n * 应额外获得 Node.js 全局变量的工程文件。\n *\n * 这些模式还会与当前已启用的 JavaScript/TypeScript 文件模式做 AND 匹配，\n * 因而关闭 TypeScript 后不会意外让 ESLint 接管 `.ts` 文件。\n */\nexport const GLOBS_NODE_TOOLING = [\n\t\"**/*.{config,setup}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{scripts,bin}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{test,tests}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/*.{test,spec}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/cli.{js,cjs,mjs,ts,cts,mts}\",\n] as const;\n\n/** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */\nexport const GLOBS_TSCONFIG = [\"**/tsconfig.json\", \"**/tsconfig.*.json\"] as const;\n\n/** 不应交给 JSON/Markdown 解析器处理的包管理器锁文件。 */\nexport const GLOBS_LOCKFILES = [\"**/package-lock.json\", \"**/yarn.lock\", \"**/pnpm-lock.yaml\", \"**/bun.lock\", \"**/bun.lockb\", \"**/deno.lock\"] as const;\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,WAAW;;AAGxB,MAAa,YAAY;;AAGzB,MAAa,0BAA0B;;AAGvC,MAAa,wBAAwB;;AAGrC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,aAAa;;AAG1B,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,CAAC,oBAAoB,eAAe;;AAGrE,MAAa,iBAAiB;CAC7B,QAAQ;CACR,iBAAiB;CACjB,mBAAmB;CACnB,KAAK;CACL,UAAU;AACX;;;;;;;;AASA,MAAa,6BAA6B;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,MAAM;CACN,IAAI;AACL;;AAGA,MAAa,aAAa;CAAC,GAAG;CAAkB,GAAG;CAAkB;AAAQ;;;;;;;AAQ7E,MAAa,qBAAqB;CACjC;CACA;CACA;CACA;CACA;AACD;;AAGA,MAAa,iBAAiB,CAAC,oBAAoB,oBAAoB;;AAGvE,MAAa,kBAAkB;CAAC;CAAwB;CAAgB;CAAqB;CAAe;CAAgB;AAAc"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/constants/index.ts"],"sourcesContent":["/**\n * `@fast-china/eslint-config/constants` 公开的文件匹配常量。\n *\n * @remarks\n * 所有模式均使用 ESLint Flat Config 的 glob 语义，可直接用于配置的 `files` 或\n * `ignores` 字段。数组常量使用只读元组类型，调用方组合时应复制而非原地修改。\n *\n * @packageDocumentation\n */\n\n/** JavaScript 与 JSX 文件；扩展名列表与 Node.js ESM/CJS 约定保持一致。 */\nexport const GLOBS_JAVASCRIPT = [\"**/*.{js,cjs,mjs,jsx}\"] as const;\n\n/** TypeScript 与 TSX 文件；包含 TypeScript 的 ESM/CJS 专用扩展名。 */\nexport const GLOBS_TYPESCRIPT = [\"**/*.{ts,cts,mts,tsx}\"] as const;\n\n/** 独立 JSX 文件；用于为 Vue 等 JSX 运行时叠加组件脚本语义规则。 */\nexport const GLOB_JSX = \"**/*.jsx\";\n\n/** 独立 TSX 文件；用于在完整 TypeScript 范围内叠加 UI 组件专项规则。 */\nexport const GLOB_TSX = \"**/*.tsx\";\n\n/** Vue 3 单文件组件。 */\nexport const GLOB_VUE = \"**/*.vue\";\n\n/** UniApp 原生渲染页面使用的 Vue 单文件组件。 */\nexport const GLOB_NVUE = \"**/*.nvue\";\n\n/** Angular 组件、指令、服务等框架源码；Angular CLI 项目以 `.ts` 为标准源码扩展名。 */\nexport const GLOB_ANGULAR_TYPESCRIPT = \"**/*.ts\";\n\n/** Angular 外部模板；内联模板由 Angular 处理器提取后复用同一模板配置。 */\nexport const GLOB_ANGULAR_TEMPLATE = \"**/*.html\";\n\n/** 严格 JSON 文件。 */\nexport const GLOB_JSON = \"**/*.json\";\n/** 允许注释与尾随逗号的 JSONC 文件。 */\nexport const GLOB_JSONC = \"**/*.jsonc\";\n/** 使用 JSON5 语法的配置文件。 */\nexport const GLOB_JSON5 = \"**/*.json5\";\n\n/** Markdown 文档。 */\nexport const GLOB_MARKDOWN = \"**/*.md\";\n\n/** UniApp 项目允许使用注释的应用清单和页面路由配置。 */\nexport const GLOBS_UNIAPP_JSON = [\"**/manifest.json\", \"**/pages.json\"] as const;\n\n/** UniApp 跨端运行时提供的公共全局变量。 */\nexport const UNIAPP_GLOBALS = {\n\tgetApp: \"readonly\",\n\tgetCurrentPages: \"readonly\",\n\tgetCurrentSubNVue: \"readonly\",\n\tuni: \"readonly\",\n\tuniCloud: \"readonly\",\n} as const;\n\n/**\n * UniApp 条件编译分支中可能由目标平台注入的全局变量。\n *\n * @remarks\n * ESLint 不执行 `#ifdef`/`#endif` 预处理，因此启用 UniApp 后统一声明这些对象。它们只解决\n * 静态 `no-undef`，不会验证当前发行目标是否真的提供对应 API。\n */\nexport const UNIAPP_CONDITIONAL_GLOBALS = {\n\tdd: \"readonly\",\n\tjd: \"readonly\",\n\tks: \"readonly\",\n\tmy: \"readonly\",\n\tplus: \"readonly\",\n\tqh: \"readonly\",\n\tqq: \"readonly\",\n\tswan: \"readonly\",\n\ttt: \"readonly\",\n\tweex: \"readonly\",\n\twx: \"readonly\",\n} as const;\n\n/** 默认由 JavaScript、TypeScript 和 Vue 规则处理的全部代码文件。 */\nexport const GLOBS_CODE = [...GLOBS_JAVASCRIPT, ...GLOBS_TYPESCRIPT, GLOB_VUE] as const;\n\n/**\n * 应额外获得 Node.js 全局变量的工程文件。\n *\n * 这些模式还会与当前已启用的 JavaScript/TypeScript 文件模式做 AND 匹配，\n * 因而关闭 TypeScript 后不会意外让 ESLint 接管 `.ts` 文件。\n */\nexport const GLOBS_NODE_TOOLING = [\n\t\"**/*.{config,setup}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{scripts,bin}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/{test,tests}/**/*.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/*.{test,spec}.{js,cjs,mjs,jsx,ts,cts,mts,tsx}\",\n\t\"**/cli.{js,cjs,mjs,ts,cts,mts}\",\n] as const;\n\n/** TypeScript 配置文件；它们使用 JSONC 语法并允许注释。 */\nexport const GLOBS_TSCONFIG = [\"**/tsconfig.json\", \"**/tsconfig.*.json\"] as const;\n\n/** 不应交给 JSON/Markdown 解析器处理的包管理器锁文件。 */\nexport const GLOBS_LOCKFILES = [\"**/package-lock.json\", \"**/yarn.lock\", \"**/pnpm-lock.yaml\", \"**/bun.lock\", \"**/bun.lockb\", \"**/deno.lock\"] as const;\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,mBAAmB,CAAC,uBAAuB;;AAGxD,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,WAAW;;AAGxB,MAAa,YAAY;;AAGzB,MAAa,0BAA0B;;AAGvC,MAAa,wBAAwB;;AAGrC,MAAa,YAAY;;AAEzB,MAAa,aAAa;;AAE1B,MAAa,aAAa;;AAG1B,MAAa,gBAAgB;;AAG7B,MAAa,oBAAoB,CAAC,oBAAoB,eAAe;;AAGrE,MAAa,iBAAiB;CAC7B,QAAQ;CACR,iBAAiB;CACjB,mBAAmB;CACnB,KAAK;CACL,UAAU;AACX;;;;;;;;AASA,MAAa,6BAA6B;CACzC,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,IAAI;CACJ,MAAM;CACN,IAAI;CACJ,MAAM;CACN,IAAI;AACL;;AAGA,MAAa,aAAa;CAAC,GAAG;CAAkB,GAAG;CAAkB;AAAQ;;;;;;;AAQ7E,MAAa,qBAAqB;CACjC;CACA;CACA;CACA;CACA;AACD;;AAGA,MAAa,iBAAiB,CAAC,oBAAoB,oBAAoB;;AAGvE,MAAa,kBAAkB;CAAC;CAAwB;CAAgB;CAAqB;CAAe;CAAgB;AAAc"}

package/dist/index.d.mts

@@ -5,84 +5,63 @@ import { Linter } from "eslint";
 //#region src/index.d.ts
 type RejectUnknownRuleNames<Rules extends RuleOptions> = Rules & Record<Exclude<keyof Rules, keyof RuleOptions>, never>;
 /**
- * 为项目规则提供精确的规则名、严重级别和规则选项自动补全。
+ * 定义带有完整规则名与选项类型检查的 ESLint 规则记录。
  *
  * @remarks
- * 该函数不会修改传入对象；它只在 TypeScript 编译阶段拒绝未知规则和无效选项。
+ * 该辅助函数只提供 TypeScript 类型约束，不会克隆、规范化或修改传入对象。规则记录可以
+ * 直接放入 Flat Config 的 `rules` 字段，也可以与本包导出的规则记录组合。
  *
- * @typeParam Rules - 调用方传入的规则记录类型；保留字面量键和值以提供精确推断。
- * @param rules - 需要进行规则名、严重级别和选项校验的 ESLint 规则记录。
- * @returns 原始规则记录。返回值同时兼容 ESLint 的通用 `RulesRecord` 类型。
- */
-export declare const defineRules: <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>) => Rules & Linter.RulesRecord;
-/**
- * 根配置工厂唯一保留的项目选项。
+ * @typeParam Rules - 基于生成规则 schema 推断出的具体规则记录类型。
+ * @param rules - 需要验证的 ESLint 规则记录；未知规则名和无效规则选项会产生类型错误。
+ * @returns 原样返回传入的规则记录，并补充 ESLint `RulesRecord` 兼容类型。
  *
- * @remarks
- * 根入口固定启用 `.gitignore`、JavaScript、类型感知 TypeScript、Vue 3、UniApp、Import、
- * RegExp、JSON、清单排序和 Prettier 兼容层。项目级规则、globals 与 ignores 应通过
- * `fastConfig()` 的后置 Flat Config 参数声明。React、Angular、Markdown 与其他可选能力
- * 应从 `@fast-china/eslint-config/configs` 显式组合。
+ * @example
+ * ```ts
+ * const rules = defineRules({
+ *   eqeqeq: ["error", "always"],
+ * });
+ * ```
  */
-export interface FastConfigOptions {
+export declare const defineRules: <const Rules extends RuleOptions>(rules: RejectUnknownRuleNames<Rules>) => Rules & Linter.RulesRecord;
+/** Vue、UniApp 与框架无关项目完整配置共享的运行环境选项。 */
+export interface ProjectConfigOptions {
   /**
-   * 应用代码实际运行的环境。
-   *
-   * - `"browser"`：提供浏览器全局变量。
-   * - `"node"`：提供 Node.js 全局变量。
-   * - `"universal"`：同时提供浏览器与 Node.js 全局变量。
-   *
-   * 配置文件、脚本、测试和 CLI 文件无论选择何种环境都会单独获得 Node.js globals。
+   * 应用代码实际运行的环境。配置、脚本、测试和 CLI 文件始终单独获得 Node.js globals。
    * @defaultValue `"browser"`
    */
   environment?: RuntimeEnvironment;
 }
 /**
- * 创建不绑定前端框架的固定基础配置。
+ * 创建不绑定前端框架的 JavaScript 与 TypeScript 完整配置。
  *
  * @remarks
- * 默认包含 `.gitignore`、JavaScript、类型感知 TypeScript、Import、RegExp、JSON、
- * `package.json`/`tsconfig*.json` 排序、Prettier 兼容层和 Node.js 工程文件覆写。
- * React、Angular、Markdown 与 Lodash 等能力由调用方从 `./configs` 子路径继续组合。
+ * TypeScript 模块的导出成员按 SDK 公共 API 检查，内部实现保留类型推断。
+ * React、Angular、Markdown 与 Lodash 等能力从 `./configs` 子路径按需组合。
  *
- * @param options - 应用代码的运行环境。
- * @returns 可作为 React、Angular、Node.js 或 SDK 项目基础的 Flat Config 数组。
+ * @param options - 应用源码的运行环境；默认仅注入浏览器全局变量。
+ * @returns 可直接传给 `eslint.config.*` 的 Flat Config 数组。
  */
-export declare const createBaseConfigs: ({ environment }?: FastConfigOptions) => Config[];
+export declare const createBaseConfigs: ({ environment }?: ProjectConfigOptions) => Config[];
 /**
- * 创建固定的 Vue 3、TypeScript 与 UniApp ESLint Flat Config。
+ * 创建处理 `.vue`、Vue JSX 与 Vue TSX，且不注入任何 UniApp 能力的 Vue 3 完整配置。
  *
- * @remarks
- * 除运行环境外，根入口不提供能力启停开关。TypeScript 和 Vue 始终使用
- * `strictTypeChecked`、`stylisticTypeChecked` 与 Project Service；被检查文件必须属于可发现的 tsconfig。
- * 额外配置会放在全部内置片段之后，因此可以覆盖项目规则、globals、ignores 或解析器选项。
- *
- * @param options - 应用代码的运行环境。
- * @param overrides - 追加到全部内置片段之后的 ESLint Flat Config。
- * @returns 可直接导出给 ESLint 的 Flat Config 数组。
- *
- * @example
- * ```ts
- * import { defineRules, fastConfig } from "@fast-china/eslint-config";
- *
- * export default fastConfig(
- *   { environment: "browser" },
- *   {
- *     files: ["src/generated/*.ts"],
- *     rules: defineRules({ "@typescript-eslint/no-unused-vars": "off" }),
- *   },
- * );
- * ```
+ * @param options - 应用源码的运行环境；默认仅注入浏览器全局变量。
+ * @param overrides - 追加在内置配置之后的项目级 Flat Config 覆写。
+ * @returns Vue 3 项目可直接使用的 Flat Config 数组。
  */
-export declare const fastConfig: ({ environment }?: FastConfigOptions, ...overrides: Config[]) => Config[];
+export declare const createVueProjectConfigs: ({ environment }?: ProjectConfigOptions, ...overrides: Config[]) => Config[];
 /**
- * 可直接导出或展开的默认 ESLint Flat Config。
+ * 创建处理 `.vue`、`.nvue`、Vue JSX/TSX、UniApp globals 与应用清单的完整配置。
  *
- * @remarks
- * 默认使用浏览器环境。需要切换运行环境或追加项目覆写时，请使用具名导出的
- * {@link fastConfig} 工厂。
+ * @param options - 应用源码的运行环境；默认仅注入浏览器全局变量。
+ * @param overrides - 追加在内置配置之后的项目级 Flat Config 覆写。
+ * @returns UniApp 项目可直接使用的 Flat Config 数组。
  */
-declare const fastChina: Config[];
+export declare const createUniAppProjectConfigs: ({ environment }?: ProjectConfigOptions, ...overrides: Config[]) => Config[];
+/** 不带项目级覆写、可直接导入使用的 Vue 3 默认配置。 */
+export declare const vueConfig: Config[];
+/** 不带项目级覆写、可直接导入使用的 UniApp 默认配置。 */
+export declare const uniAppConfig: Config[];
 //#endregion
-export { type RuleOptions, fastChina as default };
+export type { RuleOptions };
 //# sourceMappingURL=index.d.mts.map