@alexlit/lint-kit 214.4.0 → 215.0.0

package/packages/config-stylelint/README.md

@@ -1,62 +1,149 @@
-# 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)
 
-## Installation
+# Stylelint Configuration
 
-```sh
+Готовая конфигурация [Stylelint](https://stylelint.io/) для проверки CSS, SCSS и
+Vue-файлов: настроенные правила из популярных stylelint-плагинов - порядок и
+синтаксис свойств, доступность, БЭМ, поддержка SCSS и т.д. Вместо того чтобы
+подключать и настраивать каждый плагин вручную, соберите конфигурацию из готовых
+проверок.
+
+Проверки модульные: по умолчанию ничего не включено - вы сами перечисляете
+нужные в `defineConfig`.
+
+## Установка
+
+```bash
 npm i @alexlit/config-stylelint -D
 ```
 
-## Connection
+## Быстрый старт
 
-- Default
-  ([see plugins enabled by default](https://github.com/alex-lit/lint-kit/blob/master/packages/config-stylelint/index.js))
+```js
+// stylelint.config.js
+import { defineConfig, plugins } from '@alexlit/config-stylelint';
 
-  ```js
-  // stylelint.config.js
-  import { createConfig } from '@alexlit/config-stylelint';
+export default defineConfig([
+  plugins.scss(),
+  plugins.vue(),
+  plugins.prettier(),
+]);
+```
 
-  export default createConfig();
-  ```
+Каждый вызов `plugins.*()` - отдельная проверка. Добавьте только то, что нужно
+проекту; полный список - в разделе [Проверки](#проверки).
 
-- Custom
-
-  ```js
-  // stylelint.config.js
-  import { createConfig } from '@alexlit/config-stylelint';
-
-  export default createConfig(
-    {
-      // disable some default plugins
-      'no-nested-media': false,
-
-      // enable some optional plugins
-      'gamut': true,
-      'logical-css': true,
-    },
-    {
-      // add custom rules
-      rules: {
-        'custom-property-empty-line-before': [
-          'always',
-          {
-            except: ['after-comment', 'after-custom-property', 'first-nested'],
-          },
-        ],
-      },
-    },
-  );
-  ```
+Больше проверок - просто допишите их в массив:
+
+```js
+// stylelint.config.js
+import { defineConfig, plugins } from '@alexlit/config-stylelint';
+
+export default defineConfig([
+  plugins.colorFormat(),
+  plugins.declarationBlockNoIgnoredProperties(),
+  plugins.highPerformanceAnimation(),
+  plugins.noNestedMedia(),
+  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(),
+]);
+```
+
+## Настройка
+
+### Правила конкретной проверки
+
+Чтобы переопределить правила одной проверки, передайте объект в её вызов:
+
+```js
+// stylelint.config.js
+import { defineConfig, plugins } from '@alexlit/config-stylelint';
+
+export default defineConfig([
+  plugins.useNesting({ rules: { 'csstools/use-nesting': 'never' } }),
+  plugins.noUnresolvedModule({
+    rules: { 'plugin/no-unresolved-module': { alias: { '~': 'src' } } },
+  }),
+]);
+```
+
+### Общие настройки Stylelint
+
+Второй аргумент `defineConfig` - общие опции: собственные правила, файлы для
+игнора и т.д. Он перебивает настройки всех проверок:
+
+```js
+// stylelint.config.js
+import { defineConfig, plugins } from '@alexlit/config-stylelint';
+
+export default defineConfig([plugins.scss(), plugins.vue()], {
+  ignoreFiles: ['fixtures/**'],
+  rules: { 'max-nesting-depth': 3 },
+});
+```
+
+## Проверки
+
+| Проверка                                        | Что делает                                           | Плагин                                              |
+| ----------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------- |
+| `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`                  |
+
+## Миграция с v61
+
+v62 - breaking-релиз: проверок по умолчанию больше нет, всё подключается явно.
+
+| v61                             | v62                                            |
+| ------------------------------- | ---------------------------------------------- |
+| `createConfig()`                | перечислите нужные проверки явно               |
+| `createConfig({ gamut: true })` | `defineConfig([plugins.gamut()])`              |
+| `createConfig({ scss: false })` | просто не добавляйте `plugins.scss()` в список |
+| `createConfig({}, options)`     | `defineConfig([...], options)`                 |
+
+Проверки, включённые по умолчанию в v61: `color-format`,
+`declaration-block-no-ignored-properties`, `high-performance-animation`,
+`no-nested-media`, `order`, `scss`, `selector-no-empty`, `use-nesting`, `vue`, а
+также `prettier`.
 
-## Development
+## Разработка
 
-- Check rules
+- Проверка актуальности правил:
 
-  ```sh
+  ```bash
   npx stylelint-find-new-rules
   ```
 
-## Useful links
+## Полезные ссылки
 
-- [Awesome StyleLint](https://github.com/stylelint/awesome-stylelint)
+- [awesome-stylelint](https://github.com/stylelint/awesome-stylelint)
 - [stylelint-scales](https://github.com/jeddy3/stylelint-scales)
 - [stylelint-value-no-unknown-custom-properties](https://github.com/csstools/stylelint-value-no-unknown-custom-properties)

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

@@ -0,0 +1,52 @@
+import type { Config } from 'stylelint';
+
+/**
+ * Опции фабрики плагина - частичный конфиг Stylelint, накладываемый поверх
+ * значений по умолчанию.
+ */
+type PluginOptions = Partial<Config>;
+
+/**
+ * Пространство имён фабрик конфигов плагинов. Дефолтных плагинов нет -
+ * подключайте нужные явно.
+ */
+interface Plugins {
+  a11y: (options?: PluginOptions) => Config;
+  bem: (options?: PluginOptions) => Config;
+  colorFormat: (options?: PluginOptions) => Config;
+  declarationBlockNoIgnoredProperties: (options?: PluginOptions) => Config;
+  gamut: (options?: PluginOptions) => Config;
+  highPerformanceAnimation: (options?: PluginOptions) => Config;
+  logicalCss: (options?: PluginOptions) => Config;
+  mediaUseCustomMedia: (options?: PluginOptions) => Config;
+  noIndistinguishableColors: (options?: PluginOptions) => Config;
+  noNestedMedia: (options?: PluginOptions) => Config;
+  noUnresolvedModule: (options?: PluginOptions) => Config;
+  noUnsupportedBrowserFeatures: (options?: PluginOptions) => Config;
+  order: (options?: PluginOptions) => Config;
+  prettier: (options?: PluginOptions) => Config;
+  scss: (options?: PluginOptions) => Config;
+  selectorNoEmpty: (options?: PluginOptions) => Config;
+  useNesting: (options?: PluginOptions) => Config;
+  vue: (options?: PluginOptions) => Config;
+}
+
+/** Пространство имён фабрик конфигов плагинов. */
+declare const plugins: Plugins;
+
+/**
+ * Создать конфиг Stylelint.
+ *
+ * Приоритет (от низкого к высокому): база → конфиги плагинов по порядку →
+ * `options`. `extends`, `ignoreFiles`, `overrides` и `plugins` конкатенируются
+ * (дубли `plugins` убираются), `rules` - shallow merge.
+ *
+ * @param pluginConfigs - Конфиги плагинов (например, `[plugins.scss()]`)
+ * @param options - Базовые опции Stylelint, наивысший приоритет
+ */
+declare function defineConfig(
+  pluginConfigs?: Config[],
+  options?: Config,
+): Config;
+
+export { defineConfig, plugins };

package/packages/config-stylelint/index.js

@@ -1,178 +1,182 @@
 /* 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';
 
-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)|\$/,
-        },
-      },
-    ],
-    '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'] },
+const defineConfig = (pluginConfigs = [], options = {}) => {
+  const baseConfig = {
+    extends: ['stylelint-config-standard'],
+    ignoreFiles: [
+      '.*',
+      '.*/**',
+      'build/**',
+      'dist/**',
+      'docs/**',
+      'node_modules/**',
+      'storybook-*/**',
     ],
-    '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,
-  },
-});
+  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 ?? {})),
+  };
+};
 
-export { createConfig };
+export { defineConfig, plugins };

package/packages/config-stylelint/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/config-stylelint",
-  "version": "61.5.2",
+  "version": "63.0.1",
   "private": false,
   "description": "Stylelint config",
   "keywords": [
@@ -23,9 +23,11 @@
   ],
   "type": "module",
   "main": "index.js",
+  "types": "index.d.ts",
   "files": [
     "README.md",
     "index.js",
+    "index.d.ts",
     "plugins"
   ],
   "scripts": {

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

@@ -1,18 +1,31 @@
 /* eslint-disable unicorn/no-null */
 
 /**
- * @type {import('stylelint').Config}
+ * Проверяет типичные ошибки доступности.
+ *
+ * @param {Partial<import('stylelint').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию (shallow merge)
+ *
+ * @returns {import('stylelint').Config}
  *
  * @see [stylelint-a11y](https://github.com/double-great/stylelint-a11y)
  */
-export default {
-  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,
-  },
+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 },
+  };
 };