@alexlit/lint-kit 214.4.0 → 216.0.0

package/packages/config-stylelint/index.js

@@ -1,178 +1,174 @@
 /* eslint-disable unicorn/no-null */
+import { a11y } from './plugins/a11y.js';
+import { bem } from './plugins/bem.js';
+import { colorFormat } from './plugins/color-format.js';
+import { declarationBlockNoIgnoredProperties } from './plugins/declaration-block-no-ignored-properties.js';
+import { gamut } from './plugins/gamut.js';
+import { highPerformanceAnimation } from './plugins/high-performance-animation.js';
+import { logicalCss } from './plugins/logical-css.js';
+import { mediaUseCustomMedia } from './plugins/media-use-custom-media.js';
+import { noIndistinguishableColors } from './plugins/no-indistinguishable-colors.js';
+import { noNestedMedia } from './plugins/no-nested-media.js';
+import { noUnresolvedModule } from './plugins/no-unresolved-module.js';
+import { noUnsupportedBrowserFeatures } from './plugins/no-unsupported-browser-features.js';
+import { order } from './plugins/order.js';
+import { prettier } from './plugins/prettier.js';
+import { scss } from './plugins/scss.js';
+import { selectorNoEmpty } from './plugins/selector-no-empty.js';
+import { useNesting } from './plugins/use-nesting.js';
+import { vue } from './plugins/vue.js';
+import { mergeConfigs } from './utils/merge-configs.js';
 
-const DEFAULT_PLUGINS = {
-  'color-format': true,
-  'declaration-block-no-ignored-properties': true,
-  'high-performance-animation': true,
-  'no-nested-media': true,
-  'order': true,
-  'scss': true,
-  'selector-no-empty': true,
-  'use-nesting': true,
-  'vue': true,
+/** Плагины. Дефолтных плагинов нет - подключайте нужные явно в `defineConfig`. */
+const plugins = {
+  a11y,
+  bem,
+  colorFormat,
+  declarationBlockNoIgnoredProperties,
+  gamut,
+  highPerformanceAnimation,
+  logicalCss,
+  mediaUseCustomMedia,
+  noIndistinguishableColors,
+  noNestedMedia,
+  noUnresolvedModule,
+  noUnsupportedBrowserFeatures,
+  order,
+  prettier,
+  scss,
+  selectorNoEmpty,
+  useNesting,
+  vue,
 };
 
-const OPTIONAL_PLUGINS = {
-  'a11y': false,
-  'bem': false,
-  'gamut': false,
-  'logical-css': false,
-  'media-use-custom-media': false,
-  'no-indistinguishable-colors': false,
-  'no-unresolved-module': false,
-  'no-unsupported-browser-features': false,
-};
-
-const CODESTYLE_PLUGINS = { prettier: true };
-
-const PLUGINS = {
-  ...DEFAULT_PLUGINS,
-  ...OPTIONAL_PLUGINS,
-  ...CODESTYLE_PLUGINS,
+/** Базовые правила, применяются всегда (ниже опций плагинов и `options`). */
+const BASE_RULES = {
+  'alpha-value-notation': 'number',
+  'annotation-no-unknown': [true, { ignoreAnnotations: ['default'] }],
+  'at-rule-disallowed-list': ['debug'],
+  'at-rule-empty-line-before': [
+    'always',
+    {
+      except: ['blockless-after-same-name-blockless', 'first-nested'],
+      ignoreAtRules: ['else'],
+    },
+  ],
+  'at-rule-no-deprecated': [true, { ignoreAtRules: ['apply', 'tailwind'] }],
+  'at-rule-no-unknown': null,
+  'at-rule-no-vendor-prefix': true,
+  'block-no-empty': null,
+  'color-function-notation': 'modern',
+  'color-hex-length': 'short',
+  'color-no-hex': true,
+  'color-no-invalid-hex': true,
+  'custom-property-empty-line-before': [
+    'always',
+    { except: ['after-comment', 'after-custom-property', 'first-nested'] },
+  ],
+  'custom-property-pattern': '^_?[a-z]+([a-z0-9-]+[a-z0-9]+)?$',
+  'declaration-block-no-redundant-longhand-properties': null,
+  'declaration-property-value-no-unknown': [
+    true,
+    {
+      ignoreProperties: {
+        '/.+/': /(v-(bind|deep|global|slotted)|calc-size|rgb|theme|view)|\$/,
+      },
+    },
+  ],
+  'font-family-name-quotes': 'always-unless-keyword',
+  'function-no-unknown': null, // delegate to scss/function-no-unknown
+  'function-url-quotes': 'always',
+  'function-url-scheme-disallowed-list': ['/^data/', 'ftp', '/^http/'],
+  'hue-degree-notation': 'angle',
+  'keyframes-name-pattern': '^[a-z]+(-[a-z]+)*$',
+  'max-nesting-depth': [
+    6,
+    { ignoreAtRules: ['each', 'media', 'supports', 'include'] },
+  ],
+  'media-feature-name-no-unknown': [
+    true,
+    { ignoreMediaFeatureNames: ['screen'] },
+  ],
+  'media-feature-name-no-vendor-prefix': true,
+  'no-descending-specificity': null,
+  'no-empty-source': null,
+  'no-unknown-animations': true,
+  'number-max-precision': 3,
+  'property-no-unknown': [
+    true,
+    {
+      ignoreProperties: [
+        'align-tracks',
+        'animation-timeline',
+        'interpolate-size',
+        'text-stroke',
+      ],
+    },
+  ],
+  'property-no-vendor-prefix': true,
+  'rule-empty-line-before': [
+    'always',
+    { except: ['after-single-line-comment', 'first-nested'], ignore: [] },
+  ],
+  'selector-class-pattern': [
+    '^[a-z]([a-z0-9-]+)?(__([a-z0-9]+-?)+)?(--([a-z0-9]+-?)+){0,2}$',
+    {
+      message:
+        'Selector should be written as BEM "block__element--modifier--value" (selector-class-pattern)',
+    },
+  ],
+  'selector-combinator-disallowed-list': ['>>>', '/deep/'],
+  'selector-max-compound-selectors': 6,
+  'selector-max-id': 0,
+  'selector-no-qualifying-type': null,
+  'selector-no-vendor-prefix': true,
+  'selector-pseudo-element-disallowed-list': ['shadow'],
+  'selector-pseudo-element-no-unknown': [
+    true,
+    { ignorePseudoElements: ['v-deep', 'file-selector-button'] },
+  ],
+  'selector-type-no-unknown': [true, { ignoreTypes: ['ymaps'] }],
+  'shorthand-property-no-redundant-values': true,
+  'string-no-newline': null,
+  'time-min-milliseconds': 16,
+  'value-keyword-case': [
+    'lower',
+    { camelCaseSvgKeywords: true, ignoreFunctions: ['v-bind'] },
+  ],
+  'value-no-vendor-prefix': true,
 };
 
 /**
- * Create "extends" field
+ * Создать конфиг Stylelint.
  *
- * @param {PLUGINS} plugins Enabled/disabled plugins list
- */
-const createPluginsList = (plugins = {}) => {
-  const pluginsList = [];
-
-  Object.entries({ ...PLUGINS, ...plugins })?.forEach(([name, isActive]) => {
-    if (isActive) {
-      pluginsList.push(`@alexlit/config-stylelint/plugins/${name}`);
-    }
-  });
-
-  return pluginsList;
-};
-
-/**
- * Create stylelint config
+ * Приоритет (от низкого к высокому): база → конфиги плагинов по порядку →
+ * `options`. Коллекции (`extends`, `ignoreFiles`, `overrides`, `plugins`)
+ * конкатенируются (дубли `plugins` убираются), `rules` - shallow merge.
+ *
+ * @param {import('stylelint').Config[]} [pluginConfigs] - Конфиги плагинов
+ *   (например, `[plugins.scss(), plugins.vue()]`)
+ * @param {import('stylelint').Config} [options] - Базовые опции Stylelint,
+ *   наивысший приоритет
  *
- * @param {PLUGINS} plugins Enabled/disabled plugins list
- * @param {import('stylelint').Config} options Stylelint options
+ * @returns {import('stylelint').Config}
  */
-const createConfig = (plugins = {}, options = {}) => ({
-  ...options,
-
-  extends: [
-    'stylelint-config-standard',
-
-    ...createPluginsList(plugins),
-
-    ...(options.extends ?? []),
-  ],
-  ignoreFiles: [
-    '.*',
-    '.*/**',
-    'build/**',
-    'dist/**',
-    'docs/**',
-    'node_modules/**',
-    'storybook-*/**',
-
-    ...(options.ignoreFiles ?? []),
-  ],
-  plugins: options.plugins ?? [],
-  rules: {
-    'alpha-value-notation': 'number',
-    'annotation-no-unknown': [true, { ignoreAnnotations: ['default'] }],
-    'at-rule-disallowed-list': ['debug'],
-    'at-rule-empty-line-before': [
-      'always',
-      {
-        except: ['blockless-after-same-name-blockless', 'first-nested'],
-        ignoreAtRules: ['else'],
-      },
-    ],
-    'at-rule-no-deprecated': [true, { ignoreAtRules: ['apply', 'tailwind'] }],
-    'at-rule-no-unknown': null,
-    'at-rule-no-vendor-prefix': true,
-    'block-no-empty': null,
-    'color-function-notation': 'modern',
-    'color-hex-length': 'short',
-    'color-no-hex': true,
-    'color-no-invalid-hex': true,
-    'custom-property-empty-line-before': [
-      'always',
-      { except: ['after-comment', 'after-custom-property', 'first-nested'] },
-    ],
-    'custom-property-pattern': '^_?[a-z]+([a-z0-9-]+[a-z0-9]+)?$',
-    'declaration-block-no-redundant-longhand-properties': null,
-    'declaration-property-value-no-unknown': [
-      true,
-      {
-        ignoreProperties: {
-          '/.+/': /(v-(bind|deep|global|slotted)|calc-size|rgb|theme|view)|\$/,
-        },
-      },
+const defineConfig = (pluginConfigs = [], options = {}) => {
+  const baseConfig = {
+    extends: ['stylelint-config-standard'],
+    ignoreFiles: [
+      '.*',
+      '.*/**',
+      'build/**',
+      'dist/**',
+      'docs/**',
+      'node_modules/**',
+      'storybook-*/**',
     ],
-    'font-family-name-quotes': 'always-unless-keyword',
-    'function-no-unknown': null, // delegate to scss/function-no-unknown
-    'function-url-quotes': 'always',
-    'function-url-scheme-disallowed-list': ['/^data/', 'ftp', '/^http/'],
-    'hue-degree-notation': 'angle',
-    'keyframes-name-pattern': '^[a-z]+(-[a-z]+)*$',
-    'max-nesting-depth': [
-      6,
-      { ignoreAtRules: ['each', 'media', 'supports', 'include'] },
-    ],
-    'media-feature-name-no-unknown': [
-      true,
-      { ignoreMediaFeatureNames: ['screen'] },
-    ],
-    'media-feature-name-no-vendor-prefix': true,
-    'no-descending-specificity': null,
-    'no-empty-source': null,
-    'no-unknown-animations': true,
-    'number-max-precision': 3,
-    'property-no-unknown': [
-      true,
-      {
-        ignoreProperties: [
-          'align-tracks',
-          'animation-timeline',
-          'interpolate-size',
-          'text-stroke',
-        ],
-      },
-    ],
-    'property-no-vendor-prefix': true,
-    'rule-empty-line-before': [
-      'always',
-      { except: ['after-single-line-comment', 'first-nested'], ignore: [] },
-    ],
-    'selector-class-pattern': [
-      '^[a-z]([a-z0-9-]+)?(__([a-z0-9]+-?)+)?(--([a-z0-9]+-?)+){0,2}$',
-      {
-        message:
-          'Selector should be written as BEM "block__element--modifier--value" (selector-class-pattern)',
-      },
-    ],
-    'selector-combinator-disallowed-list': ['>>>', '/deep/'],
-    'selector-max-compound-selectors': 6,
-    'selector-max-id': 0,
-    'selector-no-qualifying-type': null,
-    'selector-no-vendor-prefix': true,
-    'selector-pseudo-element-disallowed-list': ['shadow'],
-    'selector-pseudo-element-no-unknown': [
-      true,
-      { ignorePseudoElements: ['v-deep', 'file-selector-button'] },
-    ],
-    'selector-type-no-unknown': [true, { ignoreTypes: ['ymaps'] }],
-    'shorthand-property-no-redundant-values': true,
-    'string-no-newline': null,
-    'time-min-milliseconds': 16,
-    'value-keyword-case': [
-      'lower',
-      { camelCaseSvgKeywords: true, ignoreFunctions: ['v-bind'] },
-    ],
-    'value-no-vendor-prefix': true,
+    plugins: [],
+    rules: BASE_RULES,
+  };
 
-    ...options.rules,
-  },
-});
+  return mergeConfigs(baseConfig, ...pluginConfigs, options);
+};
 
-export { createConfig };
+export { defineConfig, plugins };

package/packages/config-stylelint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/config-stylelint",
-  "version": "61.5.2",
+  "version": "64.0.0",
   "private": false,
   "description": "Stylelint config",
   "keywords": [
@@ -23,10 +23,13 @@
   ],
   "type": "module",
   "main": "index.js",
+  "types": "index.d.ts",
   "files": [
     "README.md",
     "index.js",
-    "plugins"
+    "index.d.ts",
+    "plugins",
+    "utils"
   ],
   "scripts": {
     "lint": "cd ../../ && ./scripts/lint.stylelint.sh",

package/packages/config-stylelint/plugins/a11y.js

@@ -1,11 +1,7 @@
 /* eslint-disable unicorn/no-null */
+import { mergeConfigs } from '../utils/merge-configs.js';
 
-/**
- * @type {import('stylelint').Config}
- *
- * @see [stylelint-a11y](https://github.com/double-great/stylelint-a11y)
- */
-export default {
+const DEFAULTS = {
   plugins: ['@double-great/stylelint-a11y'],
   rules: {
     'a11y/media-prefers-reduced-motion': null,
@@ -16,3 +12,14 @@ export default {
     'a11y/selector-pseudo-class-focus': true,
   },
 };
+
+/**
+ * Проверяет типичные ошибки доступности.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
+ *
+ * @see [stylelint-a11y](https://github.com/double-great/stylelint-a11y)
+ */
+export const a11y = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/bem.js

@@ -1,16 +1,13 @@
 /* eslint-disable unicorn/no-null */
 import { createDefineRules } from '@morev/stylelint-plugin';
 
+import { mergeConfigs } from '../utils/merge-configs.js';
+
 const defineRules = createDefineRules({
   separators: { element: '__', modifier: '--', modifierValue: '--' },
 });
 
-/**
- * @type {import('stylelint').Config}
- *
- * @see [@morev/stylelint-plugin](https://morevm.github.io/stylelint-plugin/)
- */
-export default {
+const DEFAULTS = {
   overrides: [
     {
       files: ['**/*.{css,scss,vue}'],
@@ -41,3 +38,14 @@ export default {
   ],
   plugins: ['@morev/stylelint-plugin'],
 };
+
+/**
+ * Настраивает линтинг по методологии БЭМ.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
+ *
+ * @see [@morev/stylelint-plugin](https://morevm.github.io/stylelint-plugin/)
+ */
+export const bem = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/color-format.js

@@ -1,5 +1,7 @@
 import stylelint from 'stylelint';
 
+import { mergeConfigs } from '../utils/merge-configs.js';
+
 const { createPlugin } = stylelint;
 const { report, ruleMessages, validateOptions } = stylelint.utils;
 
@@ -168,8 +170,18 @@ const rule = function (actual, options, context) {
 rule.ruleName = ruleName;
 rule.messages = messages;
 
-/** @type {import('stylelint').Config} */
-export default {
+const DEFAULTS = {
   plugins: [createPlugin(ruleName, rule)],
   rules: { 'color-format/format': { format: 'rgb' } },
 };
+
+/**
+ * Нормализует формат цветов (hex → rgb/hsl).
+ *
+ * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`extends`, `ignoreFiles`,
+ *   `overrides`, `plugins`) дополняются, `rules` мержатся поверхностно
+ *
+ * @returns {import('stylelint').Config}
+ */
+export const colorFormat = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/declaration-block-no-ignored-properties.js

@@ -1,9 +1,18 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['stylelint-declaration-block-no-ignored-properties'],
+  rules: { 'plugin/declaration-block-no-ignored-properties': true },
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Запрещает бесполезные свойства в блоке объявлений.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-declaration-block-no-ignored-properties](https://github.com/kristerkari/stylelint-declaration-block-no-ignored-properties)
  */
-export default {
-  plugins: ['stylelint-declaration-block-no-ignored-properties'],
-  rules: { 'plugin/declaration-block-no-ignored-properties': true },
-};
+export const declarationBlockNoIgnoredProperties = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/gamut.js

@@ -1,9 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['stylelint-gamut'],
+  rules: { 'gamut/color-no-out-gamut-range': true },
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Проверяет цвета на выход за пределы цветового охвата (gamut).
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-gamut](https://github.com/fpetrakov/stylelint-gamut)
  */
-export default {
-  plugins: ['stylelint-gamut'],
-  rules: { 'gamut/color-no-out-gamut-range': true },
-};
+export const gamut = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/high-performance-animation.js

@@ -1,9 +1,6 @@
-/**
- * @type {import('stylelint').Config}
- *
- * @see [stylelint-high-performance-animation](https://github.com/kristerkari/stylelint-high-performance-animation)
- */
-export default {
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
   plugins: ['stylelint-high-performance-animation'],
   rules: {
     'plugin/no-low-performance-animation-properties': [
@@ -12,3 +9,15 @@ export default {
     ],
   },
 };
+
+/**
+ * Запрещает анимации, нагружающие рендеринг.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
+ *
+ * @see [stylelint-high-performance-animation](https://github.com/kristerkari/stylelint-high-performance-animation)
+ */
+export const highPerformanceAnimation = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/logical-css.js

@@ -1,9 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  extends: ['stylelint-plugin-logical-css/configs/recommended'],
+  plugins: ['stylelint-plugin-logical-css'],
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Проверяет использование логических CSS-свойств.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-plugin-logical-css](https://github.com/yuschick/stylelint-plugin-logical-css)
  */
-export default {
-  extends: ['stylelint-plugin-logical-css/configs/recommended'],
-  plugins: ['stylelint-plugin-logical-css'],
-};
+export const logicalCss = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/media-use-custom-media.js

@@ -1,9 +1,18 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['stylelint-media-use-custom-media'],
+  rules: { 'csstools/media-use-custom-media': 'always' },
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Требует использования кастомных медиа-запросов.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-media-use-custom-media](https://github.com/csstools/stylelint-media-use-custom-media)
  */
-export default {
-  plugins: ['stylelint-media-use-custom-media'],
-  rules: { 'csstools/media-use-custom-media': 'always' },
-};
+export const mediaUseCustomMedia = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/no-indistinguishable-colors.js

@@ -1,9 +1,18 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['stylelint-no-indistinguishable-colors'],
+  rules: { 'plugin/stylelint-no-indistinguishable-colors': true },
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Запрещает неразличимые цвета.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-no-indistinguishable-colors](https://github.com/ierhyna/stylelint-no-indistinguishable-colors)
  */
-export default {
-  plugins: ['stylelint-no-indistinguishable-colors'],
-  rules: { 'plugin/stylelint-no-indistinguishable-colors': true },
-};
+export const noIndistinguishableColors = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/no-nested-media.js

@@ -1,9 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['stylelint-no-nested-media'],
+  rules: { 'pitcher/no-nested-media': true },
+};
+
 /**
- * @type {import('stylelint').Config}
+ * Запрещает вложенные медиа-запросы.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-no-nested-media](https://github.com/dkrnl/stylelint-no-nested-media)
  */
-export default {
-  plugins: ['stylelint-no-nested-media'],
-  rules: { 'pitcher/no-nested-media': true },
-};
+export const noNestedMedia = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-stylelint/plugins/no-unresolved-module.js

@@ -1,9 +1,6 @@
-/**
- * @type {import('stylelint').Config}
- *
- * @see [stylelint-no-unresolved-module](https://github.com/niksy/stylelint-no-unresolved-module)
- */
-export default {
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
   plugins: ['stylelint-no-unresolved-module'],
   rules: {
     'plugin/no-unresolved-module': {
@@ -21,3 +18,15 @@ export default {
     },
   },
 };
+
+/**
+ * Проверяет разрешение импортов.
+ *
+ * @param {Partial<import('stylelint').Config>} [options]
+ *
+ * @returns {import('stylelint').Config}
+ *
+ * @see [stylelint-no-unresolved-module](https://github.com/niksy/stylelint-no-unresolved-module)
+ */
+export const noUnresolvedModule = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);