.stylelintrc.yaml

extends:
  - stylelint-prettier/recommended
  - stylelint-config-recommended
  - stylelint-config-recommended-scss
  - stylelint-stylistic/config

ignoreFiles:
  - indico/web/static/dist/**/*.css

rules:
  # this rule is too noisy
  no-descending-specificity: null

  # complains about css rules after `@include` without an empty line
  declaration-empty-line-before: null

  # `:global()` has special meaning in css modules
  selector-pseudo-class-no-unknown:
    - true
    - ignorePseudoClasses: [global]

  selector-pseudo-element-colon-notation: double

  font-family-no-missing-generic-family-keyword:
    - true
    - ignoreFontFamilies: [icomoon-ultimate]

  at-rule-empty-line-before:
    - always
    - except:
        - first-nested
      ignore:
        - blockless-after-same-name-blockless
        - after-comment
        - inside-block

  color-hex-length: short
  length-zero-no-unit: true

  rule-empty-line-before:
    - always
    - except: [first-nested]
      ignore: [after-comment]

  value-keyword-case: lower

  scss/at-import-partial-extension: never
  scss/at-function-pattern: ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$
  scss/at-mixin-argumentless-call-parentheses: always
  scss/at-mixin-pattern: ^_?([a-z][a-z0-9]*)(-[a-z0-9]+)*$
  scss/at-rule-conditional-no-parentheses: true
  scss/dollar-variable-pattern: ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$
  scss/percent-placeholder-pattern: ^([a-z][a-z0-9]*)(-[a-z0-9]+)*$
  scss/double-slash-comment-whitespace-inside: always
  scss/declaration-nested-properties: never
  scss/dimension-no-non-numeric-values: true
  scss/load-no-partial-leading-underscore: true
  scss/media-feature-value-dollar-variable:
    - always
    - ignore: [keywords]
      severity: warning
  scss/no-duplicate-dollar-variables:
    - true
    - ignoreInside: [at-rule, nested-at-rule]
      ignoreInsideAtRules: [if, else, function, each]
  scss/no-duplicate-mixins: true

  # we have "empty" comments in our license header
  scss/comment-no-empty: null
  # we make heavy use of globals like darken() and lighten()
  scss/no-global-function-names: null
  # heavily used
  scss/at-extend-no-missing-placeholder: null
  # prettier's formatting can violate this
  scss/operator-no-newline-after: null
  # single quotes are clearly superior
  stylistic/string-quotes: single

  # these rule conflict with stylelint-prettier formatting
  stylistic/indentation: null
  stylistic/selector-descendant-combinator-no-non-space: null
  stylistic/declaration-colon-newline-after: null
  stylistic/selector-combinator-space-before: null
  stylistic/block-closing-brace-newline-after: null
  stylistic/value-list-comma-newline-after: null