@bpa-dev/stylelint-config

Общая конфигурация Stylelint для проектов BPA.

Пакет поставляется в двух вариантах:

| Конфиг | Путь | Когда использовать | | --- | --- | --- | | newly | @bpa-dev/stylelint-config/newly | Новые проекты с нативным CSS nesting | | widely | @bpa-dev/stylelint-config/widely | Проекты без nesting или с постепенной миграцией |

Оба варианта включают stylelint-config-recommended, порядок свойств из stylelint-config-recess-order, проверку Baseline (available: newly), интеграцию с Prettier и правила производительности анимаций.

Различие между конфигами — правило csstools/use-nesting: в newly оно включено (always), в widely отключено (ignore).

Установка

pnpm add -D @bpa-dev/stylelint-config prettier

prettier нужен для правила prettier/prettier. Остальные плагины и зависимости Stylelint подтягиваются транзитивно из пакета.

Подключение в package.json

Stylelint читает конфигурацию из поля "stylelint" в package.json — отдельный файл .stylelintrc не обязателен.

Базовое подключение (newly)

{
  "stylelint": {
    "extends": "@bpa-dev/stylelint-config/newly"
  }
}

Подключение widely

{
  "stylelint": {
    "extends": "@bpa-dev/stylelint-config/widely"
  }
}

Скрипты lint

{
  "scripts": {
    "lint:styles": "stylelint \"**/*.{css,scss}\"",
    "lint:styles:fix": "stylelint \"**/*.{css,scss}\" --fix"
  },
  "stylelint": {
    "extends": "@bpa-dev/stylelint-config/newly"
  }
}

Переопределение правил

Дополнительные настройки можно задать прямо в package.json поверх shared-конфига:

{
  "stylelint": {
    "extends": "@bpa-dev/stylelint-config/newly",
    "ignoreFiles": ["coverage/**", "storybook-static/**"],
    "rules": {
      "color-named": null
    }
  }
}

Несколько extends

Можно комбинировать shared-конфиг с локальными настройками через массив:

{
  "stylelint": {
    "extends": [
      "@bpa-dev/stylelint-config/widely"
    ],
    "rules": {
      "prettier/prettier": [
        true,
        {
          "singleQuote": true
        }
      ]
    }
  }
}

Полный пример package.json

{
  "name": "my-app",
  "private": true,
  "scripts": {
    "lint:styles": "stylelint \"src/**/*.{css,scss}\"",
    "lint:styles:fix": "stylelint \"src/**/*.{css,scss}\" --fix"
  },
  "devDependencies": {
    "@bpa-dev/stylelint-config": "^1.0.0",
    "prettier": "^3.0.0",
    "stylelint": "^17.0.0"
  },
  "stylelint": {
    "extends": "@bpa-dev/stylelint-config/newly",
    "ignoreFiles": ["dist/**", "build/**"]
  }
}

stylelint в devDependencies опционален: пакет уже зависит от него, но явная установка даёт предсказуемую версию в CI и IDE.

Лицензия

MIT