@huangjunsen/stylelint-config 1.0.3 → 1.0.5

package/CHANGELOG.md

@@ -0,0 +1,46 @@
+# @huangjunsen/stylelint-config
+
+## 1.0.5
+
+### Minor Changes
+
+- 新增 Vue 单文件组件支持：内置 `postcss-html` 并为 `**/*.vue` 配置 `customSyntax`，此前 `.vue` 中的 `<template>` 插值会被当作 CSS 解析，直接报 `CssSyntaxError`，表现为「Vue 项目的样式完全无法检查」
+- `customSyntax` 使用 `require.resolve` 得到的绝对路径：stylelint 16 起裸模块名会从 stylelint 自身安装目录解析，绝对路径才稳定可用
+
+## 1.0.4
+
+### Patch Changes
+
+- 补齐完整的版本变更记录，并将 CHANGELOG 纳入发布内容
+
+## 1.0.3
+
+### Minor Changes
+
+- 升级至 stylelint 17：`stylelint-config-standard` 34 → 40、`stylelint-config-standard-scss` 11 → 17、`stylelint-scss` 5 → 7
+- `peerDependencies` 放宽为 `^16.0.0 || ^17.0.0`
+
+### Patch Changes
+
+- 移除 stylelint 16 起已删除的排版与空白类规则（`indentation`、`max-line-length`、`no-extra-semicolons`、`block-*-brace-*`、`declaration-block-trailing-semicolon`、`value-list-comma-space-after` 等），避免 `Unknown rule` 报错
+- 测试运行器改用 Jest 30 + `--experimental-vm-modules` 以加载纯 ESM 的 stylelint
+- 新增配置有效性测试，断言规则均存在且未声明已移除的排版规则
+- 重写 README
+
+## 1.0.2
+
+### Patch Changes
+
+- 补充 `stylelint` peerDependencies 与发布文件声明
+
+## 1.0.1
+
+### Patch Changes
+
+- 修复脚手架场景下缺少 `configBasedir` 导致的 `extends` 解析失败
+
+## 1.0.0
+
+### Minor Changes
+
+- 首个版本：继承 `stylelint-config-standard` 与 `stylelint-config-standard-scss`，并放宽支持小程序的 `rpx` 等自定义单位

package/README.md

@@ -4,6 +4,7 @@ CSS、SCSS、Less 样式代码的共享质量检查规范。
 
 - 继承 `stylelint-config-standard` 与 `stylelint-config-standard-scss`；
 - 禁止选择器重复、未知属性、简写属性覆盖详细属性等常见错误；
+- 内置 `postcss-html`，**开箱支持 Vue 单文件组件的 `<style>` 块**；
 - **国内移动端兼容**：放宽并支持小程序的 `rpx` 等自定义单位；
 - 不含排版 / 空白类规则（缩进、换行、分号、行长度等统一交给 Prettier）。
 
@@ -41,6 +42,20 @@ module.exports = {
 
 ---
 
+## Vue 项目
+
+`.vue` 不是标准 CSS 语法，必须先由 `postcss-html` 取出 `<style>` 块，否则 stylelint 会把 `<template>` 里的插值当作 CSS 解析并报 `CssSyntaxError`。
+
+本配置已内置该能力，无需再安装 `stylelint-config-html`，直接扫描 `.vue` 文件即可：
+
+```bash
+npx stylelint "src/**/*.{vue,css,scss,less}"
+```
+
+`customSyntax` 用的是 `require.resolve('postcss-html')` 得到的**绝对路径**：stylelint 16 起，配置中的裸模块名会从 stylelint 自身安装目录解析，只有绝对路径才稳定可用。
+
+---
+
 ## stylelint 16 起的变更
 
 stylelint 16 移除了全部**排版与空白类（stylistic）规则**，本配置同步清理，不再声明：

package/index.js

@@ -1,3 +1,10 @@
+/**
+ * Vue 单文件组件的 <style> 解析器
+ *
+ * 用 require.resolve 取绝对路径，避免 stylelint 从自身安装目录解析裸模块名而失败
+ */
+const postcssHtml = require.resolve('postcss-html');
+
 module.exports = {
     defaultSeverity: 'warning',  // 设置所有规则的默认严重性级别。
     plugins: ['stylelint-scss'], // 引入 stylelint-scss 插件，启用 SCSS 特定的规则。
@@ -71,5 +78,18 @@ module.exports = {
       'scss/double-slash-comment-whitespace-inside': 'always', // SCSS 中双斜杠注释内必须有空白。
     },
     ignoreFiles: ['**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx'], // 指定 stylelint 忽略的文件类型。
+
+    /**
+     * Vue 单文件组件支持
+     *
+     * .vue 不是标准 CSS 语法，必须先由 postcss-html 取出 <style> 块，
+     * 否则 stylelint 会报 CssSyntaxError（把模板里的插值当成 CSS 解析）。
+     */
+    overrides: [
+      {
+        files: ['**/*.vue'],
+        customSyntax: postcssHtml,
+      },
+    ],
   };
   

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huangjunsen/stylelint-config",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "CSS规范",
   "keywords": [
     "encode",
@@ -16,8 +16,8 @@
   },
   "files": [
     "index.js",
-    "package.json",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "repository": {
     "type": "git",
@@ -27,6 +27,7 @@
     "url": "https://github.com/huangjunsen0406/js-encode-fe-spec/issues"
   },
   "dependencies": {
+    "postcss-html": "^2.0.0",
     "stylelint-config-standard": "^40.0.0",
     "stylelint-config-standard-scss": "^17.0.0",
     "stylelint-scss": "^7.2.0"