.stylelintrc.yaml

reportNeedlessDisables: true
reportInvalidScopeDisables: true
reportDescriptionlessDisables: true
extends:
  - '@stylistic/stylelint-config'
  - stylelint-config-standard-scss
  - stylelint-config-html/vue
  - stylelint-config-recess-order
rules:
  # `modern` not supported by Sass
  color-function-notation: legacy

  # always long to be consistent
  color-hex-length: long

  # always numeric to be consistent
  font-weight-notation: numeric

  # avoid using non-global functions
  function-no-unknown:
    - true
    - ignoreFunctions:
      - theme-color
      - color-to-rgb-string
      - /^[a-z]+\.[a-z\-]+$/ # all `@use`d Sass functions

  # decrease severity for this rule only
  no-descending-specificity:
    - true
    - severity: warning

  # allow Vue pseudo elements
  selector-pseudo-element-no-unknown:
    - true
    - ignorePseudoElements: ["v-deep"]

  # simplify rules
  scss/block-no-redundant-nesting: true

  # prevent comments in generated CSS
  scss/comment-no-loud: true

  # special `@if`/`@else` formatting
  '@stylistic/block-closing-brace-newline-after':
    - always
    - ignoreAtRules:
      - if
      - else

  # allow grouping in Sass lists
  '@stylistic/value-list-max-empty-lines': 1