.stylelintrc.cjs

// .stylelintrc.cjs
module.exports = {
  extends: [
    'stylelint-config-standard', // 标准规则
    'stylelint-config-standard-vue', // Vue 适配
  ],
  plugins: [
    'stylelint-order', // CSS 属性排序插件
  ],
  overrides: [
    {
      files: ['**/*.vue'],
      customSyntax: 'postcss-html', // 解析 HTML/Vue 中的 <style>
    },
    {
      files: ['**/*.css'],
      customSyntax: 'postcss-less', // 支持 Less 语法
    },
  ],
  ignoreFiles: ['node_modules/**/*', 'dist/**/*', '**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx'],
  rules: {
    'no-empty-source': null, // 允许空样式文件
    'selector-class-pattern': null, // 不强制类名模式 (如 BEM)
    'selector-pseudo-element-no-unknown': [
      true,
      {
        // 允许 Vue 的深度选择器
        ignorePseudoElements: ['v-deep', 'deep', 'global'],
      },
    ],
    'property-no-vendor-prefix': null, // 允许浏览器前缀
    'value-no-vendor-prefix': null,
    'color-function-notation': 'modern', // 使用 rgb(0 0 0) 现代语法
    'alpha-value-notation': 'number', // 使用 rgba(0 0 0 / 0.5) 现代语法
    'function-no-unknown': [
      true,
      {
        // 允许未知函数 (可能用于 CSS-in-JS 变量等)
        ignoreFunctions: ['theme'], // 示例：忽略 theme() 函数
      },
    ],
    // CSS 属性排序规则 (一个推荐顺序，可自定义)
    'order/properties-order': [
      [
        // 定位与布局
        'position',
        'z-index',
        'top',
        'right',
        'bottom',
        'left',
        'display',
        'visibility',
        'float',
        'clear',
        'overflow',
        'overflow-x',
        'overflow-y',
        'clip',
        'zoom',
        // Flexbox
        'flex',
        'flex-grow',
        'flex-shrink',
        'flex-basis',
        'flex-flow',
        'flex-direction',
        'flex-wrap',
        'justify-content',
        'align-content',
        'align-items',
        'align-self',
        'order',
        // 盒模型
        'box-sizing',
        'width',
        'min-width',
        'max-width',
        'height',
        'min-height',
        'max-height',
        'margin',
        'margin-top',
        'margin-right',
        'margin-bottom',
        'margin-left',
        'padding',
        'padding-top',
        'padding-right',
        'padding-bottom',
        'padding-left',
        // 边框与轮廓
        'border',
        'border-width',
        'border-style',
        'border-color',
        'border-radius',
        'border-top',
        'border-top-width',
        'border-top-style',
        'border-top-color',
        'border-right',
        'border-right-width',
        'border-right-style',
        'border-right-color',
        'border-bottom',
        'border-bottom-width',
        'border-bottom-style',
        'border-bottom-color',
        'border-left',
        'border-left-width',
        'border-left-style',
        'border-left-color',
        'border-image',
        'border-image-source',
        'border-image-slice',
        'border-image-width',
        'border-image-outset',
        'border-image-repeat',
        'outline',
        'outline-width',
        'outline-style',
        'outline-color',
        'outline-offset',
        // 背景
        'background',
        'background-color',
        'background-image',
        'background-repeat',
        'background-attachment',
        'background-position',
        'background-position-x',
        'background-position-y',
        'background-clip',
        'background-origin',
        'background-size',
        // 颜色与字体
        'color',
        'font',
        'font-family',
        'font-size',
        'font-weight',
        'font-style',
        'font-variant',
        'font-size-adjust',
        'font-stretch',
        'font-effect',
        'font-emphasize',
        'font-emphasize-position',
        'font-emphasize-style',
        'line-height',
        // 文本
        'text-align',
        'text-align-last',
        'vertical-align',
        'text-decoration',
        'text-emphasis',
        'text-emphasis-color',
        'text-emphasis-style',
        'text-emphasis-position',
        'text-indent',
        'text-justify',
        'text-outline',
        'text-transform',
        'text-wrap',
        'text-overflow',
        'text-overflow-ellipsis',
        'text-overflow-mode',
        'text-shadow',
        'white-space',
        'word-spacing',
        'letter-spacing',
        // 列表
        'list-style',
        'list-style-position',
        'list-style-type',
        'list-style-image',
        // 表格
        'table-layout',
        'border-collapse',
        'border-spacing',
        'caption-side',
        'empty-cells',
        // 动画与过渡
        'transition',
        'transition-delay',
        'transition-timing-function',
        'transition-duration',
        'transition-property',
        'animation',
        'animation-name',
        'animation-duration',
        'animation-play-state',
        'animation-timing-function',
        'animation-delay',
        'animation-iteration-count',
        'animation-direction',
        // 其他
        'opacity',
        'filter',
        'transform',
        'transform-origin',
        'cursor',
        'pointer-events',
        'user-select',
        'content',
        'quotes',
        'counter-reset',
        'counter-increment',
        'resize',
        'will-change',
      ],
      { unspecified: 'bottom' }, // 未指定的属性放在底部
    ],
  },
};