@fast-china/eslint-config 2.1.0 → 2.1.1

package/CHANGELOG.md

@@ -6,9 +6,16 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 
 ## Unreleased
 
+## 2.1.1 - 2026-08-29
+
+### Added
+
+- Added `import-x/style-imports-last` to require one final, stable stylesheet import group without automatic reordering.
+
 ### Changed
 
 - Expanded the inline documentation for local ESLint rules and scoped overrides, including their purpose, important exceptions, and ownership of duplicate React checks.
+- Excluded stylesheet imports from `import-x/order` while preserving its grouping, alphabetizing, and `warnOnUnassignedImports` checks for all other imports.
 
 ## 2.1.0 - 2026-08-26
 

package/dist/configs/import.mjs

@@ -1,8 +1,13 @@
 import { GLOBS_CODE } from "../constants/index.mjs";
 import { importRules } from "../rules/import.mjs";
+import { styleAwareImportXPlugin } from "../plugins/import.mjs";
 import { defineConfig } from "eslint/config";
 import eslintPluginImportX from "eslint-plugin-import-x";
 //#region src/configs/import.ts
+const importXRecommended = {
+	...eslintPluginImportX.flatConfigs.recommended,
+	plugins: { "import-x": styleAwareImportXPlugin }
+};
 /**
 * 创建模块导入规则配置。
 *
@@ -16,8 +21,11 @@ import eslintPluginImportX from "eslint-plugin-import-x";
 const createImportConfigs = (files = GLOBS_CODE) => defineConfig([{
 	name: "@fast-china/import",
 	files: [...files],
-	extends: [eslintPluginImportX.flatConfigs.recommended],
-	rules: importRules
+	extends: [importXRecommended],
+	rules: {
+		...importRules,
+		"import-x/style-imports-last": "error"
+	}
 }]);
 //#endregion
 export { createImportConfigs };

package/dist/configs/import.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"import.mjs","names":[],"sources":["../../src/configs/import.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport eslintPluginImportX from \"eslint-plugin-import-x\";\nimport { GLOBS_CODE } from \"../constants\";\nimport { importRules } from \"../rules\";\n\n/**\n * 创建模块导入规则配置。\n *\n * @remarks\n * 共享库不猜测项目的路径别名或解析器，因此只继承 import-x 的推荐能力，\n * 与 resolver 强耦合且容易误报的规则会在本地规则记录中显式关闭。\n *\n * @param files - 应用 import-x 推荐规则与本地覆盖规则的 ESLint glob 列表。\n * @returns 包含 import-x 插件预置和本地规则的 Flat Config 数组。\n */\nexport const createImportConfigs = (files: readonly string[] = GLOBS_CODE): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/import\",\n\t\t\tfiles: [...files],\n\t\t\textends: [eslintPluginImportX.flatConfigs.recommended],\n\t\t\trules: importRules,\n\t\t},\n\t]);\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,SAAS,CAAC,oBAAoB,YAAY,WAAW;CACrD,OAAO;AACR,CACD,CAAC"}
+{"version":3,"file":"import.mjs","names":[],"sources":["../../src/configs/import.ts"],"sourcesContent":["import { defineConfig } from \"eslint/config\";\nimport eslintPluginImportX from \"eslint-plugin-import-x\";\nimport { GLOBS_CODE } from \"../constants\";\nimport { styleAwareImportXPlugin } from \"../plugins/import\";\nimport { importRules } from \"../rules\";\nimport type { ESLint } from \"eslint\";\n\nconst importXRecommended = {\n\t...eslintPluginImportX.flatConfigs.recommended,\n\tplugins: {\n\t\t// import-x 当前发布类型仍基于旧版 RuleContext；运行时接口与 ESLint 10 Flat Config 兼容。\n\t\t\"import-x\": styleAwareImportXPlugin as unknown as ESLint.Plugin,\n\t},\n};\n\n/**\n * 创建模块导入规则配置。\n *\n * @remarks\n * 共享库不猜测项目的路径别名或解析器，因此只继承 import-x 的推荐能力，\n * 与 resolver 强耦合且容易误报的规则会在本地规则记录中显式关闭。\n *\n * @param files - 应用 import-x 推荐规则与本地覆盖规则的 ESLint glob 列表。\n * @returns 包含 import-x 插件预置和本地规则的 Flat Config 数组。\n */\nexport const createImportConfigs = (files: readonly string[] = GLOBS_CODE): ReturnType<typeof defineConfig> =>\n\tdefineConfig([\n\t\t{\n\t\t\tname: \"@fast-china/import\",\n\t\t\tfiles: [...files],\n\t\t\textends: [importXRecommended],\n\t\t\trules: {\n\t\t\t\t...importRules,\n\t\t\t\t// 样式导入必须形成最后一个连续分组；规则不提供修复，避免改变 CSS 层叠顺序。\n\t\t\t\t\"import-x/style-imports-last\": \"error\",\n\t\t\t},\n\t\t},\n\t]);\n"],"mappings":";;;;;;AAOA,MAAM,qBAAqB;CAC1B,GAAG,oBAAoB,YAAY;CACnC,SAAS,EAER,YAAY,wBACb;AACD;;;;;;;;;;;AAYA,MAAa,uBAAuB,QAA2B,eAC9D,aAAa,CACZ;CACC,MAAM;CACN,OAAO,CAAC,GAAG,KAAK;CAChB,SAAS,CAAC,kBAAkB;CAC5B,OAAO;EACN,GAAG;EAEH,+BAA+B;CAChC;AACD,CACD,CAAC"}

package/dist/plugins/import.mjs

@@ -0,0 +1,61 @@
+import eslintPluginImportX from "eslint-plugin-import-x";
+//#region src/plugins/import.ts
+const STYLE_IMPORT_PATTERN = /\.(?:acss|css|less|pcss|postcss|sass|scss|sss|styl|stylus|ttss|wxss)(?:[?#].*)?$/i;
+const isStyleImport = (source) => typeof source === "string" && STYLE_IMPORT_PATTERN.test(source);
+const importOrderRule = eslintPluginImportX.rules.order;
+if (importOrderRule === void 0) throw new Error("eslint-plugin-import-x does not provide the order rule.");
+/**
+* 复用 import-x/order 的全部行为，但把样式导入交给 style-imports-last 独立处理。
+*
+* @remarks
+* import-x/order 没有按路径忽略导入的选项。如果让样式继续进入该规则，全局
+* alphabetize 会改变样式的层叠顺序，因此只过滤静态样式 import，其他副作用导入仍受
+* warnOnUnassignedImports 约束。
+*/
+const importOrderWithoutStylesRule = {
+	...importOrderRule,
+	create(context) {
+		const listeners = importOrderRule.create(context);
+		const checkImport = listeners.ImportDeclaration;
+		return {
+			...listeners,
+			ImportDeclaration(node) {
+				if (!isStyleImport(node.source.value)) checkImport?.(node);
+			}
+		};
+	}
+};
+/** 只要求样式导入形成文件顶部 import 区域的最后一个连续分组，不改变组内顺序。 */
+const styleImportsLastRule = {
+	meta: {
+		type: "suggestion",
+		docs: { description: "Require stylesheet imports to form the final contiguous import group without sorting them." },
+		schema: [],
+		messages: { styleImportsLast: "Style import `{{source}}` must occur after all non-style imports." }
+	},
+	create(context) {
+		return { Program(node) {
+			const imports = node.body.filter((statement) => statement.type === "ImportDeclaration");
+			let lastNonStyleImportIndex = -1;
+			for (const [index, statement] of imports.entries()) if (!isStyleImport(statement.source.value)) lastNonStyleImportIndex = index;
+			for (const statement of imports.slice(0, lastNonStyleImportIndex)) if (isStyleImport(statement.source.value)) context.report({
+				node: statement,
+				messageId: "styleImportsLast",
+				data: { source: statement.source.value }
+			});
+		} };
+	}
+};
+/** import-x 插件适配：样式导入不参与 import-x/order，其他规则保持上游实现。 */
+const styleAwareImportXPlugin = {
+	...eslintPluginImportX,
+	rules: {
+		...eslintPluginImportX.rules,
+		order: importOrderWithoutStylesRule,
+		"style-imports-last": styleImportsLastRule
+	}
+};
+//#endregion
+export { styleAwareImportXPlugin };
+
+//# sourceMappingURL=import.mjs.map

package/dist/plugins/import.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"import.mjs","names":[],"sources":["../../src/plugins/import.ts"],"sourcesContent":["import eslintPluginImportX from \"eslint-plugin-import-x\";\nimport type { Rule } from \"eslint\";\n\nconst STYLE_IMPORT_PATTERN = /\\.(?:acss|css|less|pcss|postcss|sass|scss|sss|styl|stylus|ttss|wxss)(?:[?#].*)?$/i;\n\nconst isStyleImport = (source: unknown): source is string => typeof source === \"string\" && STYLE_IMPORT_PATTERN.test(source);\n\nconst importOrderRule = eslintPluginImportX.rules.order;\n\nif (importOrderRule === undefined) {\n\tthrow new Error(\"eslint-plugin-import-x does not provide the order rule.\");\n}\n\n/**\n * 复用 import-x/order 的全部行为，但把样式导入交给 style-imports-last 独立处理。\n *\n * @remarks\n * import-x/order 没有按路径忽略导入的选项。如果让样式继续进入该规则，全局\n * alphabetize 会改变样式的层叠顺序，因此只过滤静态样式 import，其他副作用导入仍受\n * warnOnUnassignedImports 约束。\n */\nconst importOrderWithoutStylesRule: typeof importOrderRule = {\n\t...importOrderRule,\n\tcreate(context) {\n\t\tconst listeners = importOrderRule.create(context);\n\t\tconst checkImport = listeners.ImportDeclaration;\n\n\t\treturn {\n\t\t\t...listeners,\n\t\t\tImportDeclaration(node) {\n\t\t\t\tif (!isStyleImport(node.source.value)) {\n\t\t\t\t\tcheckImport?.(node);\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t},\n};\n\n/** 只要求样式导入形成文件顶部 import 区域的最后一个连续分组，不改变组内顺序。 */\nconst styleImportsLastRule: Rule.RuleModule = {\n\tmeta: {\n\t\ttype: \"suggestion\",\n\t\tdocs: {\n\t\t\tdescription: \"Require stylesheet imports to form the final contiguous import group without sorting them.\",\n\t\t},\n\t\tschema: [],\n\t\tmessages: {\n\t\t\tstyleImportsLast: \"Style import `{{source}}` must occur after all non-style imports.\",\n\t\t},\n\t},\n\tcreate(context) {\n\t\treturn {\n\t\t\tProgram(node) {\n\t\t\t\tconst imports = node.body.filter((statement) => statement.type === \"ImportDeclaration\");\n\t\t\t\tlet lastNonStyleImportIndex = -1;\n\n\t\t\t\tfor (const [index, statement] of imports.entries()) {\n\t\t\t\t\tif (!isStyleImport(statement.source.value)) {\n\t\t\t\t\t\tlastNonStyleImportIndex = index;\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\tfor (const statement of imports.slice(0, lastNonStyleImportIndex)) {\n\t\t\t\t\tif (isStyleImport(statement.source.value)) {\n\t\t\t\t\t\tcontext.report({\n\t\t\t\t\t\t\tnode: statement,\n\t\t\t\t\t\t\tmessageId: \"styleImportsLast\",\n\t\t\t\t\t\t\tdata: { source: statement.source.value },\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t},\n\t\t};\n\t},\n};\n\n/** import-x 插件适配：样式导入不参与 import-x/order，其他规则保持上游实现。 */\nexport const styleAwareImportXPlugin = {\n\t...eslintPluginImportX,\n\trules: {\n\t\t...eslintPluginImportX.rules,\n\t\torder: importOrderWithoutStylesRule,\n\t\t\"style-imports-last\": styleImportsLastRule,\n\t},\n};\n"],"mappings":";;AAGA,MAAM,uBAAuB;AAE7B,MAAM,iBAAiB,WAAsC,OAAO,WAAW,YAAY,qBAAqB,KAAK,MAAM;AAE3H,MAAM,kBAAkB,oBAAoB,MAAM;AAElD,IAAI,oBAAoB,KAAA,GACvB,MAAM,IAAI,MAAM,yDAAyD;;;;;;;;;AAW1E,MAAM,+BAAuD;CAC5D,GAAG;CACH,OAAO,SAAS;EACf,MAAM,YAAY,gBAAgB,OAAO,OAAO;EAChD,MAAM,cAAc,UAAU;EAE9B,OAAO;GACN,GAAG;GACH,kBAAkB,MAAM;IACvB,IAAI,CAAC,cAAc,KAAK,OAAO,KAAK,GACnC,cAAc,IAAI;GAEpB;EACD;CACD;AACD;;AAGA,MAAM,uBAAwC;CAC7C,MAAM;EACL,MAAM;EACN,MAAM,EACL,aAAa,6FACd;EACA,QAAQ,CAAC;EACT,UAAU,EACT,kBAAkB,oEACnB;CACD;CACA,OAAO,SAAS;EACf,OAAO,EACN,QAAQ,MAAM;GACb,MAAM,UAAU,KAAK,KAAK,QAAQ,cAAc,UAAU,SAAS,mBAAmB;GACtF,IAAI,0BAA0B;GAE9B,KAAK,MAAM,CAAC,OAAO,cAAc,QAAQ,QAAQ,GAChD,IAAI,CAAC,cAAc,UAAU,OAAO,KAAK,GACxC,0BAA0B;GAI5B,KAAK,MAAM,aAAa,QAAQ,MAAM,GAAG,uBAAuB,GAC/D,IAAI,cAAc,UAAU,OAAO,KAAK,GACvC,QAAQ,OAAO;IACd,MAAM;IACN,WAAW;IACX,MAAM,EAAE,QAAQ,UAAU,OAAO,MAAM;GACxC,CAAC;EAGJ,EACD;CACD;AACD;;AAGA,MAAa,0BAA0B;CACtC,GAAG;CACH,OAAO;EACN,GAAG,oBAAoB;EACvB,OAAO;EACP,sBAAsB;CACvB;AACD"}

package/dist/rules/import.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"import.mjs","names":[],"sources":["../../src/rules/import.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * 默认启用的模块导入正确性与排序规则。\n *\n * @remarks\n * 该记录补充 import-x 推荐预置，统一导入位置、重复导入及分组顺序。依赖项目 resolver\n * 的静态导出分析默认关闭，避免共享配置误判路径别名或自定义模块解析方式。\n */\nexport const importRules = {\n\t// import 必须位于其他语句之前，避免模块依赖散落在执行逻辑中。\n\t\"import-x/first\": \"error\",\n\t// 合并同一模块的重复 import，避免绑定分散或副作用被误读。\n\t\"import-x/no-duplicates\": \"error\",\n\t// 按来源分组并排序，保持所有项目一致的模块结构。\n\t\"import-x/order\": [\n\t\t\"error\",\n\t\t{\n\t\t\tgroups: [\n\t\t\t\t// Node.js 内置模块\n\t\t\t\t\"builtin\",\n\t\t\t\t// 第三方依赖\n\t\t\t\t\"external\",\n\t\t\t\t// 项目内部别名模块\n\t\t\t\t\"internal\",\n\t\t\t\t// 父级目录模块\n\t\t\t\t\"parent\",\n\t\t\t\t// 同级目录模块\n\t\t\t\t\"sibling\",\n\t\t\t\t// 当前目录入口模块\n\t\t\t\t\"index\",\n\t\t\t\t// TypeScript import = require() 导入\n\t\t\t\t\"object\",\n\t\t\t\t// TypeScript 类型导入\n\t\t\t\t\"type\",\n\t\t\t\t// 无法识别分类的导入\n\t\t\t\t\"unknown\",\n\t\t\t],\n\t\t\t// 常用平台、框架和工具依赖优先于其他第三方依赖，并按声明顺序分层排序\n\t\t\tpathGroups: [\n\t\t\t\t// uni-app 平台生态\n\t\t\t\t{ pattern: \"@dcloudio/**\", group: \"external\", position: \"before\" },\n\t\t\t\t// Vue 核心、路由、状态管理和 VueUse 生态\n\t\t\t\t{ pattern: \"{vue,@vue/**,vue-router,pinia,@pinia/**,@vueuse/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Element Plus 生态及其子路径\n\t\t\t\t{ pattern: \"{element-plus,element-plus/**,@element-plus/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Fast Element Plus 生态及其子路径\n\t\t\t\t{ pattern: \"{fast-element-plus,fast-element-plus/**,@fast-element-plus/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Fast China 组织包及其子路径\n\t\t\t\t{ pattern: \"@fast-china/**\", group: \"external\", position: \"before\" },\n\t\t\t\t// Lodash、lodash-es、lodash-unified 及其子路径\n\t\t\t\t{ pattern: \"lodash{,-es,-unified}{,/**}\", group: \"external\", position: \"before\" },\n\t\t\t],\n\t\t\t// 类型导入不参与 pathGroups 匹配，始终保留在 type 分组\n\t\t\tpathGroupsExcludedImportTypes: [\"type\"],\n\t\t\t// 所有 import 分组连续排列，不保留空行\n\t\t\t\"newlines-between\": \"never\",\n\t\t\t// 同一分组内按照模块路径字母升序排列\n\t\t\talphabetize: {\n\t\t\t\torder: \"asc\",\n\t\t\t\tcaseInsensitive: true,\n\t\t\t},\n\t\t\t// 副作用导入同样参与检查；修复前必须确认样式、polyfill 和注册器执行顺序\n\t\t\twarnOnUnassignedImports: true,\n\t\t},\n\t],\n\t// [默认关闭] Vite/TypeScript 别名由项目解析器校验，避免共享配置绑定特定 resolver。\n\t\"import-x/no-unresolved\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，namespace 导出的静态分析容易产生误报。\n\t\"import-x/namespace\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，默认导出的静态分析容易产生误报。\n\t\"import-x/default\": \"off\",\n\t// [默认关闭] 不限制同时存在默认导出与相近命名导出的模块 API 风格。\n\t\"import-x/no-named-as-default\": \"off\",\n\t// [默认关闭] 不限制通过默认导入对象访问同名属性的项目 API 风格。\n\t\"import-x/no-named-as-default-member\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，命名导出的静态分析容易产生误报。\n\t\"import-x/named\": \"off\",\n} satisfies RuleOptions;\n"],"mappings":";;;;;;;;AASA,MAAa,cAAc;CAE1B,kBAAkB;CAElB,0BAA0B;CAE1B,kBAAkB,CACjB,SACA;EACC,QAAQ;GAEP;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;EACD;EAEA,YAAY;GAEX;IAAE,SAAS;IAAgB,OAAO;IAAY,UAAU;GAAS;GAEjE;IAAE,SAAS;IAAuD,OAAO;IAAY,UAAU;GAAS;GAExG;IAAE,SAAS;IAAmD,OAAO;IAAY,UAAU;GAAS;GAEpG;IAAE,SAAS;IAAkE,OAAO;IAAY,UAAU;GAAS;GAEnH;IAAE,SAAS;IAAkB,OAAO;IAAY,UAAU;GAAS;GAEnE;IAAE,SAAS;IAA+B,OAAO;IAAY,UAAU;GAAS;EACjF;EAEA,+BAA+B,CAAC,MAAM;EAEtC,oBAAoB;EAEpB,aAAa;GACZ,OAAO;GACP,iBAAiB;EAClB;EAEA,yBAAyB;CAC1B,CACD;CAEA,0BAA0B;CAE1B,sBAAsB;CAEtB,oBAAoB;CAEpB,gCAAgC;CAEhC,uCAAuC;CAEvC,kBAAkB;AACnB"}
+{"version":3,"file":"import.mjs","names":[],"sources":["../../src/rules/import.ts"],"sourcesContent":["import type { RuleOptions } from \"../typegen\";\n\n/**\n * 默认启用的模块导入正确性与排序规则。\n *\n * @remarks\n * 该记录补充 import-x 推荐预置，统一导入位置、重复导入及分组顺序。依赖项目 resolver\n * 的静态导出分析默认关闭，避免共享配置误判路径别名或自定义模块解析方式。\n */\nexport const importRules = {\n\t// import 必须位于其他语句之前，避免模块依赖散落在执行逻辑中。\n\t\"import-x/first\": \"error\",\n\t// 合并同一模块的重复 import，避免绑定分散或副作用被误读。\n\t\"import-x/no-duplicates\": \"error\",\n\t// 非样式 import 按来源分组并排序，保持所有项目一致的模块结构。\n\t\"import-x/order\": [\n\t\t\"error\",\n\t\t{\n\t\t\tgroups: [\n\t\t\t\t// Node.js 内置模块\n\t\t\t\t\"builtin\",\n\t\t\t\t// 第三方依赖\n\t\t\t\t\"external\",\n\t\t\t\t// 项目内部别名模块\n\t\t\t\t\"internal\",\n\t\t\t\t// 父级目录模块\n\t\t\t\t\"parent\",\n\t\t\t\t// 同级目录模块\n\t\t\t\t\"sibling\",\n\t\t\t\t// 当前目录入口模块\n\t\t\t\t\"index\",\n\t\t\t\t// TypeScript import = require() 导入\n\t\t\t\t\"object\",\n\t\t\t\t// TypeScript 类型导入\n\t\t\t\t\"type\",\n\t\t\t\t// 无法识别分类的导入\n\t\t\t\t\"unknown\",\n\t\t\t],\n\t\t\t// 常用平台、框架和工具依赖优先于其他第三方依赖，并按声明顺序分层排序\n\t\t\tpathGroups: [\n\t\t\t\t// uni-app 平台生态\n\t\t\t\t{ pattern: \"@dcloudio/**\", group: \"external\", position: \"before\" },\n\t\t\t\t// Vue 核心、路由、状态管理和 VueUse 生态\n\t\t\t\t{ pattern: \"{vue,@vue/**,vue-router,pinia,@pinia/**,@vueuse/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Element Plus 生态及其子路径\n\t\t\t\t{ pattern: \"{element-plus,element-plus/**,@element-plus/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Fast Element Plus 生态及其子路径\n\t\t\t\t{ pattern: \"{fast-element-plus,fast-element-plus/**,@fast-element-plus/**}\", group: \"external\", position: \"before\" },\n\t\t\t\t// Fast China 组织包及其子路径\n\t\t\t\t{ pattern: \"@fast-china/**\", group: \"external\", position: \"before\" },\n\t\t\t\t// Lodash、lodash-es、lodash-unified 及其子路径\n\t\t\t\t{ pattern: \"lodash{,-es,-unified}{,/**}\", group: \"external\", position: \"before\" },\n\t\t\t],\n\t\t\t// 类型导入不参与 pathGroups 匹配，始终保留在 type 分组\n\t\t\tpathGroupsExcludedImportTypes: [\"type\"],\n\t\t\t// 所有 import 分组连续排列，不保留空行\n\t\t\t\"newlines-between\": \"never\",\n\t\t\t// 同一分组内按照模块路径字母升序排列\n\t\t\talphabetize: {\n\t\t\t\torder: \"asc\",\n\t\t\t\tcaseInsensitive: true,\n\t\t\t},\n\t\t\t// 非样式副作用导入同样参与检查；样式导入由 createImportConfigs 注册的本地规则独立处理\n\t\t\twarnOnUnassignedImports: true,\n\t\t},\n\t],\n\t// [默认关闭] Vite/TypeScript 别名由项目解析器校验，避免共享配置绑定特定 resolver。\n\t\"import-x/no-unresolved\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，namespace 导出的静态分析容易产生误报。\n\t\"import-x/namespace\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，默认导出的静态分析容易产生误报。\n\t\"import-x/default\": \"off\",\n\t// [默认关闭] 不限制同时存在默认导出与相近命名导出的模块 API 风格。\n\t\"import-x/no-named-as-default\": \"off\",\n\t// [默认关闭] 不限制通过默认导入对象访问同名属性的项目 API 风格。\n\t\"import-x/no-named-as-default-member\": \"off\",\n\t// [默认关闭] 未配置 resolver 时，命名导出的静态分析容易产生误报。\n\t\"import-x/named\": \"off\",\n} satisfies RuleOptions;\n"],"mappings":";;;;;;;;AASA,MAAa,cAAc;CAE1B,kBAAkB;CAElB,0BAA0B;CAE1B,kBAAkB,CACjB,SACA;EACC,QAAQ;GAEP;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;GAEA;EACD;EAEA,YAAY;GAEX;IAAE,SAAS;IAAgB,OAAO;IAAY,UAAU;GAAS;GAEjE;IAAE,SAAS;IAAuD,OAAO;IAAY,UAAU;GAAS;GAExG;IAAE,SAAS;IAAmD,OAAO;IAAY,UAAU;GAAS;GAEpG;IAAE,SAAS;IAAkE,OAAO;IAAY,UAAU;GAAS;GAEnH;IAAE,SAAS;IAAkB,OAAO;IAAY,UAAU;GAAS;GAEnE;IAAE,SAAS;IAA+B,OAAO;IAAY,UAAU;GAAS;EACjF;EAEA,+BAA+B,CAAC,MAAM;EAEtC,oBAAoB;EAEpB,aAAa;GACZ,OAAO;GACP,iBAAiB;EAClB;EAEA,yBAAyB;CAC1B,CACD;CAEA,0BAA0B;CAE1B,sBAAsB;CAEtB,oBAAoB;CAEpB,gCAAgC;CAEhC,uCAAuC;CAEvC,kBAAkB;AACnB"}

package/dist/typegen.d.mts

@@ -2333,6 +2333,10 @@ interface RuleOptions {
    * @see https://github.com/un-ts/eslint-plugin-import-x/blob/v4.17.1/docs/rules/prefer-namespace-import.md
    */
   'import-x/prefer-namespace-import'?: Linter.RuleEntry<ImportXPreferNamespaceImport>;
+  /**
+   * Require stylesheet imports to form the final contiguous import group without sorting them.
+   */
+  'import-x/style-imports-last'?: Linter.RuleEntry<[]>;
   /**
    * Forbid potentially ambiguous parse goal (`script` vs. `module`).
    * @see https://github.com/un-ts/eslint-plugin-import-x/blob/v4.17.1/docs/rules/unambiguous.md

package/docs/engineering-audit.zh.md

@@ -1,8 +1,8 @@
 # 工程质量审查报告
 
-审查日期：2026-08-26
+审查日期：2026-08-29
 
-审查对象：`@fast-china/eslint-config` 2.1.0 工作区
+审查对象：`@fast-china/eslint-config` 2.1.1 工作区
 
 ## 结论
 
@@ -11,6 +11,7 @@
 ## 当前规则模型
 
 - JavaScript、TypeScript、Import 和 RegExp 只有一套共享规则。
+- 样式导入由独立规则约束为最后一个连续分组，不参与普通 import 字母排序，也不提供自动修复。
 - TypeScript、Vue 和 React TypeScript 始终使用 `recommendedTypeChecked` 与 Project Service。
 - Vue 使用 `flat/recommended`，并叠加事件声明、kebab-case 属性、闭合标签和排序规则。
 - RegExp 使用显式审查过的正确性与安全规则，不继承完整偏好型推荐集合。

package/docs/rules-risk.md

@@ -1,6 +1,6 @@
 # Default Rules and Risk Guide
 
-This document describes the current 2.1.0 configuration model, major rules, and migration risks. Source comments explain current intent only; historical changes belong in `CHANGELOG.md`.
+This document describes the current 2.1.1 configuration model, major rules, and migration risks. Source comments explain current intent only; historical changes belong in `CHANGELOG.md`.
 
 ## Configuration model
 
@@ -43,7 +43,8 @@ The root entry is a fixed Vue 3 + TypeScript + UniApp preset:
 - `prefer-arrow-callback`, `logical-assignment-operators`, and `prefer-object-spread` are errors.
 - `prefer-exponentiation-operator` and `prefer-object-has-own` are errors.
 - `sort-imports` warns and only sorts members within one import.
-- `import-x/order` is an error with `warnOnUnassignedImports: true`.
+- `import-x/order` is an error with `warnOnUnassignedImports: true`; it still checks ordinary side-effect imports, while stylesheet imports do not participate in this rule.
+- `import-x/style-imports-last` is an error; CSS, SCSS, LESS, and related styles must form the final contiguous import group, with their internal order preserved and no automatic fix.
 
 ### TypeScript
 

package/docs/rules-risk.zh.md

@@ -1,6 +1,6 @@
 # 默认规则与风险指南
 
-本文说明 2.1.0 当前配置模型、主要规则和迁移风险。规则源码注释只解释现行意图；历史差异统一记录在 `CHANGELOG.md`。
+本文说明 2.1.1 当前配置模型、主要规则和迁移风险。规则源码注释只解释现行意图；历史差异统一记录在 `CHANGELOG.md`。
 
 ## 配置模型
 
@@ -43,7 +43,8 @@ SDK、OA、Admin、Vue Web 与 UniApp 客户端共享同一套 JavaScript、Type
 - `prefer-arrow-callback`、`logical-assignment-operators`、`prefer-object-spread` 为 `error`。
 - `prefer-exponentiation-operator`、`prefer-object-has-own` 为 `error`。
 - `sort-imports` 为 `warn`，只排序同一 import 的成员。
-- `import-x/order` 为 `error`，并设置 `warnOnUnassignedImports: true`。
+- `import-x/order` 为 `error`，并设置 `warnOnUnassignedImports: true`；它继续检查普通副作用导入，但样式导入不参与该规则。
+- `import-x/style-imports-last` 为 `error`；CSS、SCSS、LESS 等样式必须形成最后一个连续导入分组，组内顺序保持不变且不自动修复。
 
 ### TypeScript
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fast-china/eslint-config",
-	"version": "2.1.0",
+	"version": "2.1.1",
 	"description": "Practical, typed ESLint Flat Config for Vue 3, UniApp, React, Angular, Vite, TypeScript, JavaScript, and Node.js.",
 	"type": "module",
 	"keywords": [