@alexlit/lint-kit 215.0.0 → 216.1.0

package/packages/config-prettier/plugins/ruby.js

@@ -1,15 +1,21 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  overrides: [{ files: '*.html.erb', options: { parser: 'eruby-parse' } }],
+  plugins: ['@prettier/plugin-ruby', 'prettier-plugin-eruby'],
+};
+
 /**
  * Форматирует Ruby и ERB файлы
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [plugin-ruby](https://github.com/prettier/plugin-ruby)
  * @see [prettier-plugin-eruby](https://github.com/ippachi/prettier-plugin-eruby)
  */
-export const ruby = (options = {}) => ({
-  overrides: [{ files: '*.html.erb', options: { parser: 'eruby-parse' } }],
-  plugins: ['@prettier/plugin-ruby', 'prettier-plugin-eruby'],
-  ...options,
-});
+export const ruby = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/sh.js

@@ -1,13 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = { plugins: ['prettier-plugin-sh'] };
+
 /**
  * Форматирует shell-скрипты
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [prettier-plugin-sh](https://github.com/astorije/prettier-plugin-sh)
  */
-export const sh = (options = {}) => ({
-  plugins: ['prettier-plugin-sh'],
-  ...options,
-});
+export const sh = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/solidity.js

@@ -1,13 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = { plugins: ['prettier-plugin-solidity'] };
+
 /**
  * Форматирует контракты Solidity
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [prettier-plugin-solidity](https://github.com/prettier-solidity/prettier-plugin-solidity)
  */
-export const solidity = (options = {}) => ({
-  plugins: ['prettier-plugin-solidity'],
-  ...options,
-});
+export const solidity = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/sort-json.js

@@ -1,14 +1,20 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  jsonRecursiveSort: true,
+  plugins: ['prettier-plugin-sort-json'],
+};
+
 /**
  * Рекурсивно сортирует ключи JSON-объектов
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [prettier-plugin-sort-json](https://github.com/Gudahtt/prettier-plugin-sort-json)
  */
-export const sortJson = (options = {}) => ({
-  jsonRecursiveSort: true,
-  plugins: ['prettier-plugin-sort-json'],
-  ...options,
-});
+export const sortJson = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/sql.js

@@ -1,13 +1,17 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = { plugins: ['prettier-plugin-sql'] };
+
 /**
  * Форматирует SQL-запросы
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [prettier-plugin-sql](https://github.com/un-ts/prettier/tree/master/packages/sql)
  */
-export const sql = (options = {}) => ({
-  plugins: ['prettier-plugin-sql'],
-  ...options,
-});
+export const sql = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/tailwindcss.js

@@ -1,13 +1,6 @@
-/**
- * Сортирует утилитарные классы Tailwind CSS по каноническому порядку
- *
- * @param {Partial<import('prettier').Config>} [options]
- *
- * @returns {import('prettier').Config}
- *
- * @see [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)
- */
-export const tailwindcss = (options = {}) => ({
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
   plugins: ['prettier-plugin-tailwindcss'],
   tailwindFunctions: [
     'classnames',
@@ -19,5 +12,18 @@ export const tailwindcss = (options = {}) => ({
     'tw',
     'twMerge',
   ],
-  ...options,
-});
+};
+
+/**
+ * Сортирует утилитарные классы Tailwind CSS по каноническому порядку
+ *
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
+ *
+ * @returns {import('prettier').Config}
+ *
+ * @see [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)
+ */
+export const tailwindcss = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/plugins/xml.js

@@ -1,14 +1,20 @@
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['@prettier/plugin-xml'],
+  xmlWhitespaceSensitivity: 'ignore',
+};
+
 /**
  * Форматирует XML-файлы
  *
- * @param {Partial<import('prettier').Config>} [options]
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
  *
  * @returns {import('prettier').Config}
  *
  * @see [plugin-xml](https://github.com/prettier/plugin-xml)
  */
-export const xml = (options = {}) => ({
-  plugins: ['@prettier/plugin-xml'],
-  xmlWhitespaceSensitivity: 'ignore',
-  ...options,
-});
+export const xml = (options = {}) => mergeConfigs(DEFAULTS, options);

package/packages/config-prettier/utils/merge-configs.js

@@ -0,0 +1,18 @@
+/**
+ * Объединяет конфигурации Prettier
+ *
+ * Коллекции `overrides` и `plugins` дополняются: пользовательские значения идут
+ * после дефолтных, поэтому более поздние overrides выигрывают. `plugins`
+ * дедуплицируются. Остальные поля заменяются значениями из последующих
+ * конфигураций.
+ *
+ * @param {...import('prettier').Config} configs Конфигурации в порядке
+ *   приоритета
+ *
+ * @returns {import('prettier').Config} Объединённая конфигурация
+ */
+export const mergeConfigs = (...configs) => ({
+  ...Object.assign({}, ...configs),
+  overrides: configs.flatMap((config) => config.overrides ?? []),
+  plugins: [...new Set(configs.flatMap((config) => config.plugins ?? []))],
+});

package/packages/config-stylelint/README.md

@@ -1,9 +1,9 @@
+# Stylelint Configuration
+
 [![version](https://npmx.dev/api/registry/badge/version/@alexlit/config-stylelint)](https://www.npmjs.com/package/@alexlit/config-stylelint)
 [![downloads](https://npmx.dev/api/registry/badge/downloads/@alexlit/config-stylelint)](https://npmx.dev/package/@alexlit/config-stylelint)
 [![license](https://npmx.dev/api/registry/badge/license/@alexlit/config-stylelint)](LICENSE)
 
-# Stylelint Configuration
-
 Готовая конфигурация [Stylelint](https://stylelint.io/) для проверки CSS, SCSS и
 Vue-файлов: настроенные правила из популярных stylelint-плагинов - порядок и
 синтаксис свойств, доступность, БЭМ, поддержка SCSS и т.д. Вместо того чтобы
@@ -28,6 +28,7 @@ import { defineConfig, plugins } from '@alexlit/config-stylelint';
 export default defineConfig([
   plugins.scss(),
   plugins.vue(),
+
   plugins.prettier(),
 ]);
 ```
@@ -42,22 +43,23 @@ export default defineConfig([
 import { defineConfig, plugins } from '@alexlit/config-stylelint';
 
 export default defineConfig([
+  plugins.a11y(),
+  plugins.bem(),
   plugins.colorFormat(),
   plugins.declarationBlockNoIgnoredProperties(),
+  plugins.gamut(),
   plugins.highPerformanceAnimation(),
+  plugins.logicalCss(),
+  plugins.mediaUseCustomMedia(),
   plugins.noNestedMedia(),
+  plugins.noUnresolvedModule(),
+  plugins.noUnsupportedBrowserFeatures(),
   plugins.order(),
   plugins.scss(),
   plugins.selectorNoEmpty(),
   plugins.useNesting(),
   plugins.vue(),
-  plugins.a11y(),
-  plugins.bem(),
-  plugins.gamut(),
-  plugins.logicalCss(),
-  plugins.mediaUseCustomMedia(),
-  plugins.noUnresolvedModule(),
-  plugins.noUnsupportedBrowserFeatures(),
+
   plugins.prettier(),
 ]);
 ```
@@ -80,6 +82,40 @@ export default defineConfig([
 ]);
 ```
 
+`rules` мержатся поверхностно: настройка одноимённого правила из опций заменяет
+дефолтную целиком.
+
+### Правила для отдельных файлов
+
+Чтобы применить правила только к части файлов, используйте `overrides` в опциях
+проверки. Пользовательские overrides добавляются после дефолтных, поэтому
+выигрывают у них:
+
+```js
+// stylelint.config.js
+import { defineConfig, plugins } from '@alexlit/config-stylelint';
+
+export default defineConfig([
+  plugins.useNesting({
+    overrides: [
+      { files: ['**/*.vue'], rules: { 'csstools/use-nesting': 'never' } },
+    ],
+  }),
+]);
+```
+
+`files` обязателен: Stylelint падает с ошибкой, если в override его нет.
+
+### Приоритет настроек
+
+Внутри одной проверки: дефолты → `options.rules` → `options.overrides` (для
+подходящих файлов). Между проверками и вторым аргументом `defineConfig`
+действует тот же порядок: база → проверки по порядку → `options`.
+
+Коллекции (`extends`, `ignoreFiles`, `overrides`, `plugins`) дополняются,
+`plugins` дедуплицируются. Остальные поля, например `customSyntax`, заменяются
+значениями из опций.
+
 ### Общие настройки Stylelint
 
 Второй аргумент `defineConfig` - общие опции: собственные правила, файлы для
@@ -97,26 +133,41 @@ export default defineConfig([plugins.scss(), plugins.vue()], {
 
 ## Проверки
 
-| Проверка                                        | Что делает                                           | Плагин                                              |
-| ----------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------- |
-| `plugins.a11y()`                                | Проверяет типичные ошибки доступности                | `@double-great/stylelint-a11y`                      |
-| `plugins.bem()`                                 | Настраивает линтинг по методологии БЭМ               | `@morev/stylelint-plugin`                           |
-| `plugins.colorFormat()`                         | Нормализует формат цветов (hex → rgb/hsl)            | встроенное правило `color-format/format`            |
-| `plugins.declarationBlockNoIgnoredProperties()` | Запрещает бесполезные свойства в блоке объявлений    | `stylelint-declaration-block-no-ignored-properties` |
-| `plugins.gamut()`                               | Проверяет цвета на выход за пределы цветового охвата | `stylelint-gamut`                                   |
-| `plugins.highPerformanceAnimation()`            | Запрещает анимации, нагружающие рендеринг            | `stylelint-high-performance-animation`              |
-| `plugins.logicalCss()`                          | Проверяет использование логических CSS-свойств       | `stylelint-plugin-logical-css`                      |
-| `plugins.mediaUseCustomMedia()`                 | Требует использования кастомных медиа-запросов       | `stylelint-media-use-custom-media`                  |
-| `plugins.noIndistinguishableColors()`           | Запрещает неразличимые цвета                         | `stylelint-no-indistinguishable-colors`             |
-| `plugins.noNestedMedia()`                       | Запрещает вложенные медиа-запросы                    | `stylelint-no-nested-media`                         |
-| `plugins.noUnresolvedModule()`                  | Проверяет разрешение импортов                        | `stylelint-no-unresolved-module`                    |
-| `plugins.noUnsupportedBrowserFeatures()`        | Проверяет поддержку CSS-функций целевыми браузерами  | `stylelint-no-unsupported-browser-features`         |
-| `plugins.order()`                               | Настраивает порядок свойств и селекторов             | `stylelint-order`                                   |
-| `plugins.prettier()`                            | Интегрирует Prettier                                 | `stylelint-prettier`                                |
-| `plugins.scss()`                                | Настраивает линтинг SCSS                             | `stylelint-scss`                                    |
-| `plugins.selectorNoEmpty()`                     | Запрещает пустые селекторы                           | `stylelint-selector-no-empty`                       |
-| `plugins.useNesting()`                          | Требует использования CSS-вложенности                | `stylelint-use-nesting`                             |
-| `plugins.vue()`                                 | Подключает поддержку Vue.js SFC                      | `stylelint-config-recommended-vue`                  |
+| Проверка                                        | Что делает                                           | Плагин                                                                                                                                  |
+| ----------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `plugins.a11y()`                                | Проверяет типичные ошибки доступности                | [`@double-great/stylelint-a11y`](https://github.com/double-great/stylelint-a11y)                                                        |
+| `plugins.bem()`                                 | Настраивает линтинг по методологии БЭМ               | [`@morev/stylelint-plugin`](https://morevm.github.io/stylelint-plugin/)                                                                 |
+| `plugins.colorFormat()`                         | Нормализует формат цветов (hex → rgb/hsl)            | встроенное правило `color-format/format`                                                                                                |
+| `plugins.declarationBlockNoIgnoredProperties()` | Запрещает бесполезные свойства в блоке объявлений    | [`stylelint-declaration-block-no-ignored-properties`](https://github.com/kristerkari/stylelint-declaration-block-no-ignored-properties) |
+| `plugins.gamut()`                               | Проверяет цвета на выход за пределы цветового охвата | [`stylelint-gamut`](https://github.com/fpetrakov/stylelint-gamut)                                                                       |
+| `plugins.highPerformanceAnimation()`            | Запрещает анимации, нагружающие рендеринг            | [`stylelint-high-performance-animation`](https://github.com/kristerkari/stylelint-high-performance-animation)                           |
+| `plugins.logicalCss()`                          | Проверяет использование логических CSS-свойств       | [`stylelint-plugin-logical-css`](https://github.com/yuschick/stylelint-plugin-logical-css)                                              |
+| `plugins.mediaUseCustomMedia()`                 | Требует использования кастомных медиа-запросов       | [`stylelint-media-use-custom-media`](https://github.com/csstools/stylelint-media-use-custom-media)                                      |
+| `plugins.noIndistinguishableColors()`           | Запрещает неразличимые цвета                         | [`stylelint-no-indistinguishable-colors`](https://github.com/ierhyna/stylelint-no-indistinguishable-colors)                             |
+| `plugins.noNestedMedia()`                       | Запрещает вложенные медиа-запросы                    | [`stylelint-no-nested-media`](https://github.com/dkrnl/stylelint-no-nested-media)                                                       |
+| `plugins.noUnresolvedModule()`                  | Проверяет разрешение импортов                        | [`stylelint-no-unresolved-module`](https://github.com/niksy/stylelint-no-unresolved-module)                                             |
+| `plugins.noUnsupportedBrowserFeatures()`        | Проверяет поддержку CSS-функций целевыми браузерами  | [`stylelint-no-unsupported-browser-features`](https://github.com/ismay/stylelint-no-unsupported-browser-features)                       |
+| `plugins.order()`                               | Настраивает порядок свойств и селекторов             | [`stylelint-order`](https://github.com/hudochenkov/stylelint-order)                                                                     |
+| `plugins.prettier()`                            | Интегрирует Prettier                                 | [`stylelint-prettier`](https://github.com/prettier/stylelint-prettier)                                                                  |
+| `plugins.scss()`                                | Настраивает линтинг SCSS                             | [`stylelint-scss`](https://github.com/kristerkari/stylelint-scss)                                                                       |
+| `plugins.selectorNoEmpty()`                     | Запрещает пустые селекторы                           | [`stylelint-selector-no-empty`](https://github.com/ssivanatarajan/stylelint-selector-no-empty)                                          |
+| `plugins.useNesting()`                          | Требует использования CSS-вложенности                | [`stylelint-use-nesting`](https://github.com/csstools/stylelint-use-nesting)                                                            |
+| `plugins.vue()`                                 | Подключает поддержку Vue.js SFC                      | [`stylelint-config-recommended-vue`](https://github.com/ota-meshi/stylelint-config-recommended-vue)                                     |
+
+## Миграция с v63
+
+v64 - major-релиз: коллекции в опциях проверок теперь дополняют дефолты, а не
+заменяют их.
+
+| Было                                                      | Стало                                                               |
+| --------------------------------------------------------- | ------------------------------------------------------------------- |
+| `plugins.scss({ extends: ['custom'] })` заменял дефолтный | `extends` дополняется, `custom` применяется после дефолтного        |
+| `plugins.useNesting({ plugins: ['custom'] })` заменял     | `plugins` дополняется, дубли убираются                              |
+| `plugins.bem({ overrides: [...] })` заменял дефолтные     | overrides дополняются, пользовательские применяются после дефолтных |
+
+Отключить конкретное дефолтное правило можно через `rules: { 'rule': null }`.
+Общие настройки, которые должны перебивать всё, передавайте вторым аргументом
+`defineConfig`.
 
 ## Миграция с v61
 

package/packages/config-stylelint/index.d.ts

@@ -3,6 +3,10 @@ import type { Config } from 'stylelint';
 /**
  * Опции фабрики плагина - частичный конфиг Stylelint, накладываемый поверх
  * значений по умолчанию.
+ *
+ * Коллекции (`extends`, `ignoreFiles`, `overrides`, `plugins`) дополняют
+ * значения по умолчанию, `rules` мержатся поверхностно, остальные поля
+ * заменяются. Для каждого элемента `overrides` обязателен `files`.
  */
 type PluginOptions = Partial<Config>;
 

package/packages/config-stylelint/index.js

@@ -17,6 +17,7 @@ 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';
 
 /** Плагины. Дефолтных плагинов нет - подключайте нужные явно в `defineConfig`. */
 const plugins = {
@@ -141,8 +142,8 @@ const BASE_RULES = {
  * Создать конфиг Stylelint.
  *
  * Приоритет (от низкого к высокому): база → конфиги плагинов по порядку →
- * `options`. `extends`, `ignoreFiles`, `overrides` и `plugins` конкатенируются
- * (дубли `plugins` убираются), `rules` - shallow merge.
+ * `options`. Коллекции (`extends`, `ignoreFiles`, `overrides`, `plugins`)
+ * конкатенируются (дубли `plugins` убираются), `rules` - shallow merge.
  *
  * @param {import('stylelint').Config[]} [pluginConfigs] - Конфиги плагинов
  *   (например, `[plugins.scss(), plugins.vue()]`)
@@ -167,16 +168,7 @@ const defineConfig = (pluginConfigs = [], options = {}) => {
     rules: BASE_RULES,
   };
 
-  const sources = [baseConfig, ...pluginConfigs, options];
-
-  return {
-    ...Object.assign({}, ...sources),
-    extends: sources.flatMap((source) => source.extends ?? []),
-    ignoreFiles: sources.flatMap((source) => source.ignoreFiles ?? []),
-    overrides: sources.flatMap((source) => source.overrides ?? []),
-    plugins: [...new Set(sources.flatMap((source) => source.plugins ?? []))],
-    rules: Object.assign({}, ...sources.map((source) => source.rules ?? {})),
-  };
+  return mergeConfigs(baseConfig, ...pluginConfigs, options);
 };
 
 export { defineConfig, plugins };

package/packages/config-stylelint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/config-stylelint",
-  "version": "63.0.1",
+  "version": "64.0.0",
   "private": false,
   "description": "Stylelint config",
   "keywords": [
@@ -28,7 +28,8 @@
     "README.md",
     "index.js",
     "index.d.ts",
-    "plugins"
+    "plugins",
+    "utils"
   ],
   "scripts": {
     "lint": "cd ../../ && ./scripts/lint.stylelint.sh",

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

@@ -1,31 +1,25 @@
 /* eslint-disable unicorn/no-null */
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
+  plugins: ['@double-great/stylelint-a11y'],
+  rules: {
+    'a11y/media-prefers-reduced-motion': null,
+    'a11y/no-obsolete-attribute': true,
+    'a11y/no-obsolete-element': true,
+    'a11y/no-outline-none': true,
+    'a11y/no-text-align-justify': true,
+    'a11y/selector-pseudo-class-focus': true,
+  },
+};
 
 /**
  * Проверяет типичные ошибки доступности.
  *
- * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
- *   поверх значений по умолчанию (shallow merge)
+ * @param {Partial<import('stylelint').Config>} [options]
  *
  * @returns {import('stylelint').Config}
  *
  * @see [stylelint-a11y](https://github.com/double-great/stylelint-a11y)
  */
-export const a11y = (options = {}) => {
-  const baseConfig = {
-    plugins: ['@double-great/stylelint-a11y'],
-    rules: {
-      'a11y/media-prefers-reduced-motion': null,
-      'a11y/no-obsolete-attribute': true,
-      'a11y/no-obsolete-element': true,
-      'a11y/no-outline-none': true,
-      'a11y/no-text-align-justify': true,
-      'a11y/selector-pseudo-class-focus': true,
-    },
-  };
-
-  return {
-    ...baseConfig,
-    ...options,
-    rules: { ...baseConfig.rules, ...options.rules },
-  };
-};
+export const a11y = (options = {}) => mergeConfigs(DEFAULTS, options);

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

@@ -1,21 +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: '--' },
 });
 
-/**
- * Настраивает линтинг по методологии БЭМ.
- *
- * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
- *   поверх значений по умолчанию (shallow merge)
- *
- * @returns {import('stylelint').Config}
- *
- * @see [@morev/stylelint-plugin](https://morevm.github.io/stylelint-plugin/)
- */
-export const bem = (options = {}) => ({
+const DEFAULTS = {
   overrides: [
     {
       files: ['**/*.{css,scss,vue}'],
@@ -45,6 +37,15 @@ export const bem = (options = {}) => ({
     },
   ],
   plugins: ['@morev/stylelint-plugin'],
+};
 
-  ...options,
-});
+/**
+ * Настраивает линтинг по методологии БЭМ.
+ *
+ * @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,18 +170,18 @@ const rule = function (actual, options, context) {
 rule.ruleName = ruleName;
 rule.messages = messages;
 
+const DEFAULTS = {
+  plugins: [createPlugin(ruleName, rule)],
+  rules: { 'color-format/format': { format: 'rgb' } },
+};
+
 /**
  * Нормализует формат цветов (hex → rgb/hsl).
  *
  * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
- *   поверх значений по умолчанию (shallow merge)
+ *   поверх значений по умолчанию. Коллекции (`extends`, `ignoreFiles`,
+ *   `overrides`, `plugins`) дополняются, `rules` мержатся поверхностно
  *
  * @returns {import('stylelint').Config}
  */
-export const colorFormat = (options = {}) => ({
-  plugins: [createPlugin(ruleName, rule)],
-
-  ...options,
-
-  rules: { 'color-format/format': { format: 'rgb' }, ...options.rules },
-});
+export const colorFormat = (options = {}) => mergeConfigs(DEFAULTS, options);

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

@@ -1,20 +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 },
+};
+
 /**
  * Запрещает бесполезные свойства в блоке объявлений.
  *
- * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
- *   поверх значений по умолчанию (shallow merge)
+ * @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 const declarationBlockNoIgnoredProperties = (options = {}) => ({
-  plugins: ['stylelint-declaration-block-no-ignored-properties'],
-
-  ...options,
-
-  rules: {
-    'plugin/declaration-block-no-ignored-properties': true,
-    ...options.rules,
-  },
-});
+export const declarationBlockNoIgnoredProperties = (options = {}) =>
+  mergeConfigs(DEFAULTS, options);

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

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