chore: migrate to eslint flat config and prettier 3

.cnb.yml

@@ -23,5 +23,4 @@ $:
         - docker
       stages:
         - name: install dependencies
-          script: pnpm install 
-
+          script: pnpm install

.github/ISSUE_TEMPLATE/bug-report.zh-CN.yml

@@ -1,7 +1,7 @@
 name: 反馈 Bug
 description: 通过 github 模板进行 Bug 反馈。
-title: "[组件名称] 描述问题的标题"
-labels: [🐞 bug,🧐 unconfirmed]
+title: '[组件名称] 描述问题的标题'
+labels: [🐞 bug, 🧐 unconfirmed]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/feature-report.zh-CN.yml

@@ -1,7 +1,7 @@
 name: 反馈新功能
 description: 通过 github 模板进行新功能反馈。
-title: "[组件名称] 描述问题的标题"
-labels: [💪🏻 enhancement,🧐 unconfirmed]
+title: '[组件名称] 描述问题的标题'
+labels: [💪🏻 enhancement, 🧐 unconfirmed]
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/new-component.zh-CN.md

@@ -4,21 +4,21 @@ about: 新组件招募
 title: ''
 labels: ''
 assignees: ''
-
 ---
 
 <!--
 参考样例：
 issue label 需要设置为 help wanted，发起招募
 -->
-## 组件名称中英文
 
+## 组件名称中英文
 
 ### 交互稿
 
 <!--
 需要给到 CoDesign 分享地址，不需要登录访问
 -->
+
 交互稿：
 
 ### 设计稿
@@ -42,4 +42,3 @@ issue label 需要设置为 help wanted，发起招募
 详细提交过程请参考：[如何贡献](https://tdesign.tencent.com/about/contributing)。
 
 欢迎填写[《贡献者加入意向收集》](https://wj.qq.com/s2/9772260/7cbe/)问卷加入 TDesign 贡献者群，参与过程中遇到的各类问题可以得到实时解答和指引。
-

.github/workflows/ci.yml

@@ -2,7 +2,7 @@ name: ci
 
 on:
   pull_request:
-    branches: [ main]
+    branches: [main]
     types: [opened, synchronize, reopened]
 
 jobs:

.github/workflows/pkg-pr-new.yml

@@ -31,7 +31,7 @@ jobs:
       - run: pnpm --filter '@tdesign/site-components' --filter '@tdesign/theme-generator' run build
 
       - run: pnpm dlx pkg-pr-new publish './packages/site-components' './packages/theme-generator'
-  
+
   build-tdesign-vue-site:
     if: github.repository == 'Tencent/tdesign' && github.event_name == 'pull_request'
     needs: build
@@ -278,14 +278,13 @@ jobs:
 
       - run: pnpm uniapp build:npm
 
-      - run: pnpm -C packages/tdesign-uniapp/example build:h5 --mode preview 
+      - run: pnpm -C packages/tdesign-uniapp/example build:h5 --mode preview
 
       - uses: actions/upload-artifact@v7
         with:
           name: tdesign-uniapp-site
           path: packages/tdesign-uniapp/site/dist
-          retention-days: 5      
-
+          retention-days: 5
 
   build-site:
     if: github.repository == 'Tencent/tdesign' && github.event_name == 'pull_request'

.github/workflows/service-update-schedule.yml

@@ -5,12 +5,12 @@ name: service-update-schedule
 on:
   workflow_dispatch:
   schedule:
-    - cron: "0 0 * * 5"
+    - cron: '0 0 * * 5'
 
 jobs:
   create-report:
     # prevents this action from running on forks
-    if: github.repository == 'Tencent/tdesign' 
+    if: github.repository == 'Tencent/tdesign'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v7

.gitignore

@@ -18,4 +18,8 @@ static_site
 lib
 
 ## test
-coverage
+coverage
+
+## lint cache
+.eslintcache
+.stylelintcache

.husky/commit-msg

@@ -1,4 +1 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
 npx --no -- commitlint --edit "$1"

.husky/pre-commit

@@ -1,4 +1,13 @@
 #!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
+npx lint-staged || exit $?
 
-npx lint-staged && log_emails=$(git config user.email) && if [[ ${log_emails} =~ '@tencent.com' ]];then echo 本地提交邮箱 $log_emails 校验非法，需要本地更改重新提交 && exit 2;else echo 邮箱 $log_emails 校验通过;fi
+log_emails=$(git config user.email)
+case "$log_emails" in
+  *@tencent.com)
+    echo "本地提交邮箱 $log_emails 校验非法，需要本地更改重新提交"
+    exit 2
+    ;;
+  *)
+    echo "邮箱 $log_emails 校验通过"
+    ;;
+esac

.husky/prepare-commit-msg

@@ -1,4 +1 @@
-#!/usr/bin/env sh
-. "$(dirname "$0")/_/husky.sh"
-
-npx czg --hook || true
+npx czg --hook || true

.stylelintignore

@@ -0,0 +1,11 @@
+node_modules
+.pnpm-store
+
+# build output
+_site
+dist
+results
+static_site
+lib
+coverage
+_data

.stylelintrc.js

@@ -1,18 +1,64 @@
 module.exports = {
   extends: ['stylelint-config-standard', 'stylelint-config-standard-less'],
+  overrides: [
+    {
+      files: ['**/*.vue'],
+      customSyntax: 'postcss-html',
+    },
+    {
+      // 内置主题 token 由 TDesign 设计平台导出并直接 import ?raw 使用，
+      // 保留其原始格式（百分比透明度等），不参与本地格式治理
+      files: ['**/themes/built-in/css/**/*.css'],
+      rules: {
+        'alpha-value-notation': null,
+        'custom-property-empty-line-before': null,
+        'no-duplicate-selectors': null,
+      },
+    },
+  ],
   rules: {
-    'number-leading-zero': 'never',
     'color-function-notation': 'legacy',
     'alpha-value-notation': 'number',
     // TODO 后面统一改 class 小写 且 BEM，当前按警告提示
+    // 兼容 tdoc 插件（vite-plugin-tdoc）生成的固定目录类名 tdesign-toc_*
     'selector-class-pattern': [
-      '^[a-z]+([-]?[a-z0-9]+)*(__[a-z0-9]([-]?[a-z0-9]+)*)?(--[a-z0-9]([-]?[a-z0-9]+)*)?$',
+      '^[a-z]+([-]?[a-z0-9]+)*(__[a-z0-9]([-]?[a-z0-9]+)*)?(--[a-z0-9]([-]?[a-z0-9]+)*)?$|^tdesign-toc_',
       {
         resolveNestedSelectors: true,
         message: 'Expected class selector "%s" to be lowercase and BEM format',
         severity: 'warning',
       },
     ],
     'media-feature-range-notation': 'prefix',
+    // 存量 less 中存在同优先级选择器靠书写顺序覆盖的写法，放开该规则以避免大规模重构引发样式回归；
+    // 该规则检查的是「低优先级选择器出现在高优先级之后」，与 Less 嵌套展开无关。
+    // 注意：本次不治理此项，新代码仍应避免低优先级覆盖高优先级的写法。
+    'no-descending-specificity': null,
+
+    // TDesign 设计 token 采用 camelCase 命名（如 --td-font-size-title-extraLarge、--td-comp-paddingLR-xs），
+    // 属于设计规范约定，不对 custom property 名称做 kebab-case 强制
+    'custom-property-pattern': null,
+    // 字体名保持原始大小写（PingFang SC、Microsoft YaHei 等），不做小写化
+    'value-keyword-case': null,
+    // 关键帧名称沿用设计 token 命名风格
+    'keyframes-name-pattern': null,
+    // Vue 单文件组件使用 :deep() 等作用域样式伪类
+    'selector-pseudo-class-no-unknown': [
+      true,
+      {
+        ignorePseudoClasses: ['deep', 'global', 'slotted'],
+      },
+    ],
+    // 设计系统需要保留 -webkit- / -moz- 等厂商前缀以兼容旧版 Safari / 小程序等运行时，
+    // 不交由 stylelint 移除（自动前缀由构建侧 postcss/autoprefixer 负责）
+    'property-no-vendor-prefix': null,
+    'value-no-vendor-prefix': null,
+    'selector-no-vendor-prefix': null,
+    'at-rule-no-vendor-prefix': null,
+    // 保留历史写法（如 rgba() 兼容函数、小数点精度），避免对已上线样式造成回归
+    'color-function-alias-notation': null,
+    'number-max-precision': null,
+    // 设计系统会声明特定字体（如 PingFang SC、TCloud Number），不强制追加通用字体族
+    'font-family-no-missing-generic-family-keyword': null,
   },
 };

.vscode/settings.json

@@ -1,30 +1,28 @@
 {
-  "typescript.preferences.importModuleSpecifier": "relative",
+  "js/ts.preferences.importModuleSpecifier": "relative",
+
   "eslint.validate": ["javascript", "javascriptreact", "typescript", "typescriptreact", "vue"],
-  "[html]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
+  "stylelint.validate": ["css", "less", "vue"],
+
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit",
+    "source.fixAll.stylelint": "explicit"
   },
-  "[typescriptreact]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[javascriptreact]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[typescript]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[javascript]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "[vue]": {
-    "editor.formatOnSave": true,
-    "editor.defaultFormatter": "esbenp.prettier-vscode"
-  },
-  "cSpell.words": ["miniprogram", "tdesign", "uniapp"],
+
+  "[html]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[javascript]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[typescript]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[vue]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[json]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[jsonc]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[markdown]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[css]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[less]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+  "[yaml]": { "editor.formatOnSave": true, "editor.defaultFormatter": "esbenp.prettier-vscode" },
+
+  "prettier.requireConfig": true,
+  "files.eol": "\n",
+
+  "cSpell.words": ["miniprogram", "tdesign", "uniapp", "stylelint", "postcss", "wxss", "husky", "pnpm"],
   "cSpell.ignorePaths": ["pnpm-lock.yaml", "node_modules", ".git", ".vscode"]
 }

README.md

@@ -24,10 +24,10 @@ The following are the repositories for TDesign：
 
 ### Repositories for Mobile Components
 
-| Repository                                                              | Description                                      | Status                                                                                                                                                                                                                    |
-| ----------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [tdesign-miniprogram](https://github.com/Tencent/tdesign-miniprogram)   | Wechat MiniProgram UI components lib for TDesign | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-miniprogram/latest&color=blue)](https://npmjs.com/package/tdesign-miniprogram)         |
-| [tdesign-mobile-vue](https://github.com/Tencent/tdesign-mobile-vue)     | Vue3.x Mobile UI components lib for TDesign      | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-vue/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-vue)           |
+| Repository                                                              | Description                                      | Status                                                                                                                                                                                                              |
+| ----------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [tdesign-miniprogram](https://github.com/Tencent/tdesign-miniprogram)   | Wechat MiniProgram UI components lib for TDesign | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-miniprogram/latest&color=blue)](https://npmjs.com/package/tdesign-miniprogram)   |
+| [tdesign-mobile-vue](https://github.com/Tencent/tdesign-mobile-vue)     | Vue3.x Mobile UI components lib for TDesign      | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-vue/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-vue)     |
 | [tdesign-mobile-react](https://github.com/Tencent/tdesign-mobile-react) | React Mobile UI components lib for TDesign       | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-react/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-react) |
 | [tdesign-flutter](https://github.com/Tencent/tdesign-flutter)           | Flutter UI components lib for TDesign            | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=latest.version&url=https://pub.dev/api/packages/tdesign_flutter&color=blue)](https://pub.dev/packages/tdesign_flutter)          |
 | [tdesign-uniapp](https://github.com/Tencent/tdesign-miniprogram)        | Uniapp UI components lib for TDesign             | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/@tdesign/uniapp/latest&color=blue)](https://npmjs.com/package/@tdesign/uniapp)           |
@@ -139,7 +139,6 @@ For more information, refer to the guide section of each component, such as [But
 
 https://tdesign.tencent.com/contributor.html
 
-
 ## Contributing Guide
 
 Any contributions to TDesign are welcome. Please read [《contributing for TDesign》](https://tdesign.tencent.com/about/contributing) for more information.

README_zh-CN.md

@@ -25,10 +25,10 @@ TDesign 是一个 `multi-repo`， TDesign 有如下代码仓库：
 
 ### 移动端组件库
 
-| 仓库                                                                    | 描述                        | 状态                                                                                                                                                                                                                      |
-| ----------------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [tdesign-miniprogram](https://github.com/Tencent/tdesign-miniprogram)   | TDesign 微信小程序组件库    | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-miniprogram/latest&color=blue)](https://npmjs.com/package/tdesign-miniprogram)         |
-| [tdesign-mobile-vue](https://github.com/Tencent/tdesign-mobile-vue)     | TDesign Vue3.x 移动端组件库 | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-vue/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-vue)           |
+| 仓库                                                                    | 描述                        | 状态                                                                                                                                                                                                                |
+| ----------------------------------------------------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [tdesign-miniprogram](https://github.com/Tencent/tdesign-miniprogram)   | TDesign 微信小程序组件库    | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-miniprogram/latest&color=blue)](https://npmjs.com/package/tdesign-miniprogram)   |
+| [tdesign-mobile-vue](https://github.com/Tencent/tdesign-mobile-vue)     | TDesign Vue3.x 移动端组件库 | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-vue/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-vue)     |
 | [tdesign-mobile-react](https://github.com/Tencent/tdesign-mobile-react) | TDesign React 移动端组件库  | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/tdesign-mobile-react/latest&color=blue)](https://npmjs.com/package/tdesign-mobile-react) |
 | [tdesign-flutter](https://github.com/Tencent/tdesign-flutter)           | TDesign Flutter 组件库      | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=latest.version&url=https://pub.dev/api/packages/tdesign_flutter&color=blue)](https://pub.dev/packages/tdesign_flutter)          |
 | [tdesign-uniapp](https://github.com/Tencent/tdesign-miniprogram)        | TDesign Uniapp 组件库       | [![LTS](https://img.shields.io/badge/dynamic/json?style=flat-square&label=LTS&query=version&url=https://registry.npmjs.org/@tdesign/uniapp/latest&color=blue)](https://npmjs.com/package/@tdesign/uniapp)           |

docs/CODE_OF_CONDUCT.md

@@ -43,4 +43,4 @@ Project maintainers who do not follow or enforce the Code of Conduct in good fai
 This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version].
 
 [homepage]: http://contributor-covenant.org
-[version]: http://contributor-covenant.org/version/1/4/
+[version]: http://contributor-covenant.org/version/1/4/