@application-kit/stylelint-config 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @application-kit/stylelint-config
+
+## 0.1.0
+
+### Minor Changes
+
+- a1c3322: Новый пакет: пресет stylelint для стилей `.vue`, `.scss` и `.css` — `stylelint-config-standard` и `-standard-scss`, `recommended-vue`, порядок свойств `recess-order`, стилистика `@stylistic/stylelint-plugin`, синтаксис Vue SFC через `postcss-html`. Плагины и конфиги приходят зависимостями пакета, потребитель ставит только `stylelint` и подключает пресет через `extends`. `ignoreFiles` и свои правила остаются у потребителя: stylelint разрешает `ignoreFiles` от каталога объявившего конфига.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 application-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,45 @@
-# Temporary Holding Version
+# @application-kit/stylelint-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Пресет stylelint приложения на пакетах `@application-kit`: стили `.vue`, `.scss` и `.css`. База —
+`stylelint-config-standard` и `stylelint-config-standard-scss`, Vue SFC — `stylelint-config-recommended-vue` с
+синтаксисом `postcss-html`, порядок свойств — `stylelint-config-recess-order`, стилистика — `@stylistic/stylelint-plugin`.
+
+## Установка
+
+```sh
+yarn add --dev @application-kit/stylelint-config stylelint
+```
+
+Плагины и конфиги приходят зависимостями пакета, peer-зависимость одна — `stylelint`. Пакет — только ESM.
+
+## Подключение
+
+```js
+// stylelint.config.mjs
+export default {
+  extends: ['@application-kit/stylelint-config'],
+  ignoreFiles: ['coverage/**', 'dist/**'],
+}
+```
+
+`ignoreFiles` задаёт потребитель: stylelint разрешает его от каталога конфига, который его объявил, и из пресета шаблоны
+указывали бы внутрь `node_modules`. Свои правила потребитель дописывает в `rules` после `extends`, и они перекрывают
+пресет. Пример — шаблон классов BEM:
+
+```js
+export default {
+  extends: ['@application-kit/stylelint-config'],
+  rules: {
+    'selector-class-pattern': [String.raw`^[a-z][a-z0-9]*(-[a-z0-9]+)*(__[a-z0-9]+(-[a-z0-9]+)*)?$`],
+  },
+}
+```
+
+## Что задаёт пресет
+
+| Область | Правила |
+|---------|---------|
+| Стилистика | `@stylistic/*`: отступ 2, нижний регистр hex, свойств и единиц, ведущий ноль, двойные кавычки в `.scss` и `.css` |
+| `.vue` | синтаксис `postcss-html`, одинарные кавычки, `url()` без кавычек |
+| Vue и SCSS | псевдоклассы `:deep`, `:global`, `:slotted`, псевдоэлементы `::v-*`, at-правило `@use` |
+| Отключено | `no-descending-specificity`, `property-no-vendor-prefix`, `media-query-no-invalid` |

package/index.js

@@ -0,0 +1,71 @@
+import postcssHtml from 'postcss-html'
+
+// ignoreFiles пресету не задать: stylelint разрешает его от каталога объявившего конфига, то есть внутри node_modules.
+export default {
+  extends: [
+    'stylelint-config-html',
+    'stylelint-config-recess-order',
+    'stylelint-config-recommended-vue',
+    'stylelint-config-recommended-vue/scss',
+    'stylelint-config-standard',
+    'stylelint-config-standard-scss',
+  ],
+  overrides: [
+    {
+      // Синтаксис — модулем, а не строкой: строку stylelint импортирует из своего каталога, и она находилась бы
+      // только при поднятом в корень node_modules postcss-html.
+      customSyntax: postcssHtml,
+      files: ['**/*.vue'],
+      rules: {
+        '@stylistic/string-quotes': 'single',
+        'function-url-quotes': 'never',
+      },
+    },
+  ],
+  plugins: ['@stylistic/stylelint-plugin'],
+  rules: {
+    '@stylistic/color-hex-case': 'lower',
+    '@stylistic/declaration-bang-space-after': 'never',
+    '@stylistic/declaration-bang-space-before': 'always',
+    '@stylistic/declaration-block-semicolon-newline-after': 'always',
+    '@stylistic/declaration-colon-space-before': 'never',
+    '@stylistic/function-max-empty-lines': 0,
+    '@stylistic/function-parentheses-newline-inside': 'never-multi-line',
+    '@stylistic/function-parentheses-space-inside': 'never',
+    '@stylistic/function-whitespace-after': 'always',
+    '@stylistic/indentation': [2, { baseIndentLevel: 0, indentInsideParens: 'once-at-root-twice-in-block' }],
+    '@stylistic/linebreaks': 'unix',
+    '@stylistic/max-empty-lines': 1,
+    '@stylistic/max-line-length': [120, { ignore: ['comments', 'non-comments'] }],
+    '@stylistic/no-empty-first-line': true,
+    '@stylistic/no-extra-semicolons': true,
+    '@stylistic/number-leading-zero': 'always',
+    '@stylistic/number-no-trailing-zeros': true,
+    '@stylistic/property-case': 'lower',
+    '@stylistic/string-quotes': 'double',
+    '@stylistic/unit-case': 'lower',
+    '@stylistic/value-list-max-empty-lines': 0,
+    'at-rule-empty-line-before': [
+      'always',
+      { except: ['blockless-after-same-name-blockless'], ignore: ['after-comment'] },
+    ],
+    'at-rule-no-unknown': [true, { ignoreAtRules: 'use' }],
+    'declaration-block-no-duplicate-properties': true,
+    'declaration-property-value-no-unknown': true,
+    'import-notation': 'string',
+    'length-zero-no-unit': true,
+    'media-query-no-invalid': null,
+    'no-descending-specificity': null,
+    'no-irregular-whitespace': true,
+    'property-no-vendor-prefix': null,
+    'rule-empty-line-before': [
+      'always-multi-line',
+      {
+        ignore: ['first-nested', 'after-comment'],
+      },
+    ],
+    'selector-pseudo-class-no-unknown': [true, { ignorePseudoClasses: ['deep', 'global', 'slotted'] }],
+    'selector-pseudo-element-no-unknown': [true, { ignorePseudoElements: ['/^v-/'] }],
+    'shorthand-property-no-redundant-values': true,
+  },
+}

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@application-kit/stylelint-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Пресет stylelint приложения на пакетах @application-kit: стили .vue, .scss и .css — порядок свойств recess, стилистика @stylistic, Vue SFC через postcss-html",
+  "keywords": [
+    "stylelint",
+    "stylelint-config",
+    "vue"
+  ],
+  "homepage": "https://gitlab.com/application-kit/application-kit/-/tree/main/packages/stylelint-config",
+  "bugs": "https://gitlab.com/application-kit/application-kit/-/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://gitlab.com/application-kit/application-kit.git",
+    "directory": "packages/stylelint-config"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "application-kit"
+  },
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": "./index.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./index.js",
+  "files": [
+    "index.js"
+  ],
+  "dependencies": {
+    "@stylistic/stylelint-plugin": "^5.3.0",
+    "postcss-html": "^2.0.0",
+    "stylelint-config-html": "^2.0.0",
+    "stylelint-config-recess-order": "^7.8.0",
+    "stylelint-config-recommended": "^18.0.0",
+    "stylelint-config-recommended-scss": "^17.0.0",
+    "stylelint-config-recommended-vue": "^2.0.0",
+    "stylelint-config-standard": "^40.0.0",
+    "stylelint-config-standard-scss": "^17.0.0",
+    "stylelint-order": "^8.1.1"
+  },
+  "devDependencies": {
+    "stylelint": "^17.14.1"
+  },
+  "peerDependencies": {
+    "stylelint": "^17.6.0"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }