@alexlit/lint-kit 214.4.0 → 216.0.0

package/packages/config-prettier/README.md

@@ -1,37 +1,172 @@
 # Prettier Configuration
 
-## Installation
+[![version](https://npmx.dev/api/registry/badge/version/@alexlit/config-prettier)](https://www.npmjs.com/package/@alexlit/config-prettier)
+[![downloads](https://npmx.dev/api/registry/badge/downloads/@alexlit/config-prettier)](https://npmx.dev/package/@alexlit/config-prettier)
+[![license](https://npmx.dev/api/registry/badge/license/@alexlit/config-prettier)](LICENSE)
 
-```sh
+Готовая конфигурация [Prettier](https://prettier.io/) с плагинами для
+форматирования языков и форматов, которых Prettier не поддерживает из коробки
+(PHP, SQL, шаблоны, shell-скрипты и т.д.), а также расширений для сортировки
+JSON и утилит Tailwind CSS. Вместо того чтобы подключать и настраивать каждый
+плагин вручную, соберите конфигурацию из готовых модулей.
+
+Плагины модульные: по умолчанию ничего не включено - вы сами перечисляете нужные
+в `defineConfig`.
+
+## Установка
+
+```bash
 npm i @alexlit/config-prettier -D
 ```
 
-## Connection
+## Быстрый старт
+
+```js
+// prettier.config.js
+import { defineConfig, plugins } from '@alexlit/config-prettier';
+
+export default defineConfig([plugins.packageJson(), plugins.xml()]);
+```
+
+Каждый вызов `plugins.*()` - отдельный плагин. Добавьте только то, что нужно
+проекту; полный список - в разделе [Плагины](#плагины).
+
+Больше плагинов - просто допишите их в массив:
+
+```js
+// prettier.config.js
+import { defineConfig, plugins } from '@alexlit/config-prettier';
+
+export default defineConfig([
+  plugins.jsdoc(),
+  plugins.mdc(),
+  plugins.packageJson(),
+  plugins.php(),
+  plugins.pug(),
+  plugins.ruby(),
+  plugins.sh(),
+  plugins.sortJson(),
+  plugins.solidity(),
+  plugins.sql(),
+  plugins.tailwindcss(),
+  plugins.xml(),
+]);
+```
+
+## Настройка
+
+### Настройки конкретного плагина
+
+Чтобы переопределить настройки одного плагина, передайте объект в его вызов:
+
+```js
+// prettier.config.js
+import { defineConfig, plugins } from '@alexlit/config-prettier';
+
+export default defineConfig([
+  plugins.sortJson({ jsonRecursiveSort: false }),
+  plugins.tailwindcss({ tailwindFunctions: ['cn', 'cva'] }),
+]);
+```
+
+Скалярные опции заменяют значения плагина, а `plugins` и `overrides` дополняют
+дефолтные списки. Подробнее - в разделе
+[Приоритет настроек](#приоритет-настроек).
+
+### Общие настройки Prettier
+
+Второй аргумент `defineConfig` - общие опции Prettier. Он перебивает настройки
+всех плагинов:
+
+```js
+// prettier.config.js
+import { defineConfig, plugins } from '@alexlit/config-prettier';
+
+export default defineConfig([plugins.php()], {
+  printWidth: 100,
+  singleQuote: false,
+});
+```
+
+### Приоритет настроек
+
+Настройки применяются в таком порядке:
+
+1. Базовые опции пакета.
+2. Конфиги плагинов в порядке массива `defineConfig`.
+3. Второй аргумент `defineConfig`.
+
+Скалярные опции перекрывают друг друга. Коллекции `plugins` и `overrides`
+дополняются, а не заменяются. `plugins` дедуплицируются, поэтому один и тот же
+плагин можно безопасно указать несколько раз.
+
+Для `overrides` более позднее правило выигрывает: пользовательские overrides
+идут после дефолтных и перекрывают их при совпадении `files`.
+
+### Правила для отдельных файлов
+
+`overrides` из фабрики добавляются к дефолтным. Например, чтобы форматировать
+документацию как обычный Markdown, оставив MDC для остальных файлов:
+
+```js
+// prettier.config.js
+import { defineConfig, plugins } from '@alexlit/config-prettier';
+
+export default defineConfig([
+  plugins.mdc({
+    overrides: [{ files: ['docs/**/*.md'], options: { parser: 'markdown' } }],
+  }),
+]);
+```
+
+Пустой массив `overrides: []` не отключает дефолтные правила. Чтобы
+переопределить поведение, добавьте свой override с теми же `files` - он будет
+применён после дефолтного.
+
+## Плагины
+
+| Плагин                  | Что делает                                      | Пакет                                                                                                                                            |
+| ----------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `plugins.jsdoc()`       | Нормализует JSDoc-комментарии                   | [`prettier-plugin-jsdoc`](https://github.com/hosseinmd/prettier-plugin-jsdoc)                                                                    |
+| `plugins.mdc()`         | Форматирует MDC-документы (Nuxt Content)        | [`prettier-plugin-mdc`](https://github.com/so1ve/prettier-plugin-mdc)                                                                            |
+| `plugins.packageJson()` | Сортирует ключи в package.json                  | [`prettier-plugin-packagejson`](https://github.com/matzkoh/prettier-plugin-packagejson)                                                          |
+| `plugins.php()`         | Форматирует PHP-файлы                           | [`@prettier/plugin-php`](https://github.com/prettier/plugin-php)                                                                                 |
+| `plugins.pug()`         | Форматирует Pug-шаблоны с сортировкой атрибутов | [`@prettier/plugin-pug`](https://github.com/prettier/plugin-pug)                                                                                 |
+| `plugins.ruby()`        | Форматирует Ruby и ERB файлы                    | [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby) + [`prettier-plugin-eruby`](https://github.com/ippachi/prettier-plugin-eruby) |
+| `plugins.sh()`          | Форматирует shell-скрипты                       | [`prettier-plugin-sh`](https://github.com/astorije/prettier-plugin-sh)                                                                           |
+| `plugins.sortJson()`    | Рекурсивно сортирует ключи JSON-объектов        | [`prettier-plugin-sort-json`](https://github.com/Gudahtt/prettier-plugin-sort-json)                                                              |
+| `plugins.solidity()`    | Форматирует контракты Solidity                  | [`prettier-plugin-solidity`](https://github.com/prettier-solidity/prettier-plugin-solidity)                                                      |
+| `plugins.sql()`         | Форматирует SQL-запросы                         | [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql)                                                              |
+| `plugins.tailwindcss()` | Сортирует утилитарные классы Tailwind CSS       | [`prettier-plugin-tailwindcss`](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)                                                     |
+| `plugins.xml()`         | Форматирует XML-файлы                           | [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml)                                                                                 |
+
+## Миграция с v24
+
+v25 - breaking-релиз: `plugins` и `overrides`, переданные в фабрику, теперь
+дополняют дефолтные значения, а не заменяют их.
 
-- Default
-  ([see plugins enabled by default](https://github.com/alex-lit/lint-kit/blob/master/packages/config-prettier/index.js#L5))
+| v24                                                       | v25                                              |
+| --------------------------------------------------------- | ------------------------------------------------ |
+| `plugins.mdc({ plugins: ['custom'] })` заменял MDC-плагин | добавляет `custom` к `prettier-plugin-mdc`       |
+| `plugins.mdc({ overrides: [...] })` заменял MDC-override  | добавляет overrides после дефолтного             |
+| `plugins.ruby({ overrides: [] })` отключал ERB-override   | не отключает; добавьте override для `*.html.erb` |
 
-  ```js
-  // prettier.config.js
-  import { createConfig } from '@alexlit/config-prettier';
+Скалярные опции работают как раньше: значения из `options` заменяют дефолтные.
 
-  export default createConfig();
-  ```
+## Миграция с v23
 
-- Custom
+v24 - breaking-релиз: плагинов по умолчанию больше нет, всё подключается явно.
 
-  ```js
-  // prettier.config.js
-  import { createConfig } from '@alexlit/config-prettier';
+| v23                            | v24                                           |
+| ------------------------------ | --------------------------------------------- |
+| `createConfig()`               | перечислите нужные плагины явно               |
+| `createConfig({ php: true })`  | `defineConfig([plugins.php()])`               |
+| `createConfig({ sql: false })` | просто не добавляйте `plugins.sql()` в список |
+| `createConfig({}, options)`    | `defineConfig([...], options)`                |
 
-  export default createConfig({
-    php: true,
-    ruby: true,
-    sql: false,
-    tailwindcss: false,
-  });
-  ```
+Плагины, включённые по умолчанию в v23: `jsdoc`, `mdc`, `packagejson`, `pug`,
+`sh`, `solidity`, `sort-json`, `xml`.
 
-## Issues
+## Известные проблемы
 
-- **tailwindcss** conflicts with **jsdoc**
+- **tailwindcss** ранее конфликтовал с **jsdoc**

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

@@ -0,0 +1,100 @@
+import type { Config } from 'prettier';
+
+/**
+ * Options of
+ * [prettier-plugin-jsdoc](https://github.com/hosseinmd/prettier-plugin-jsdoc)
+ */
+export interface JsdocOptions {
+  jsdocCommentLineStrategy?: 'fallback' | 'multiLine' | 'singleLine';
+  jsdocSeparateReturnsFromParam?: boolean;
+  jsdocSeparateTagGroups?: boolean;
+}
+
+/**
+ * Plugin factories. Every plugin is connected explicitly: pass
+ * `plugins.<name>()` to `defineConfig`.
+ *
+ * Collection options (`overrides`, `plugins`) are appended to the defaults:
+ * `plugins` are deduplicated and later `overrides` win. Other options replace
+ * default values.
+ */
+export interface Plugins {
+  /** @see prettier-plugin-jsdoc */
+  jsdoc(options?: Config & JsdocOptions): Config;
+  /** @see prettier-plugin-mdc */
+  mdc(options?: Config): Config;
+  /** @see prettier-plugin-packagejson */
+  packageJson(options?: Config): Config;
+  /** @see plugin-php */
+  php(options?: Config): Config;
+  /** @see plugin-pug */
+  pug(options?: Config & PugOptions): Config;
+  /** @see plugin-ruby */
+  ruby(options?: Config): Config;
+  /** @see prettier-plugin-sh */
+  sh(options?: Config): Config;
+  /** @see prettier-plugin-solidity */
+  solidity(options?: Config): Config;
+  /** @see prettier-plugin-sort-json */
+  sortJson(options?: Config & SortJsonOptions): Config;
+  /** @see prettier-plugin-sql */
+  sql(options?: Config): Config;
+  /** @see prettier-plugin-tailwindcss */
+  tailwindcss(options?: Config & TailwindcssOptions): Config;
+  /** @see plugin-xml */
+  xml(options?: Config & XmlOptions): Config;
+}
+
+/** Options of [plugin-pug](https://github.com/prettier/plugin-pug) */
+export interface PugOptions {
+  pugCommentPreserveSpaces?: string;
+  pugSingleQuote?: boolean;
+  pugSortAttributes?: 'asc' | 'desc' | 'natural' | false;
+  pugWrapAttributesThreshold?: number;
+}
+
+/**
+ * Options of
+ * [prettier-plugin-sort-json](https://github.com/Gudahtt/prettier-plugin-sort-json)
+ */
+export interface SortJsonOptions {
+  jsonRecursiveSort?: boolean;
+}
+
+/**
+ * Options of
+ * [prettier-plugin-tailwindcss](https://github.com/tailwindlabs/prettier-plugin-tailwindcss)
+ */
+export interface TailwindcssOptions {
+  tailwindFunctions?: string[];
+}
+
+/** Options of [plugin-xml](https://github.com/prettier/plugin-xml) */
+export interface XmlOptions {
+  xmlWhitespaceSensitivity?: 'ignore' | 'preserve' | 'strict';
+}
+
+export declare const plugins: Plugins;
+
+/**
+ * Create prettier config
+ *
+ * There are no default plugins - connect the required ones explicitly:
+ *
+ * ```js
+ * defineConfig([plugins.php(), plugins.tailwindcss()], {
+ *   printWidth: 100,
+ * });
+ * ```
+ *
+ * Base options are replaced by plugin options and `options`. Collection options
+ * (`overrides`, `plugins`) are appended: `plugins` are deduplicated and later
+ * `overrides` win.
+ *
+ * @param pluginConfigs Plugin configs, e.g. `[plugins.php()]`
+ * @param options Base prettier options (highest precedence)
+ */
+export declare function defineConfig(
+  pluginConfigs?: Config[],
+  options?: Config,
+): Config;

package/packages/config-prettier/index.js

@@ -1,96 +1,74 @@
-import { omit } from 'radash';
+import { jsdoc } from './plugins/jsdoc.js';
+import { mdc } from './plugins/mdc.js';
+import { packageJson } from './plugins/packagejson.js';
+import { php } from './plugins/php.js';
+import { pug } from './plugins/pug.js';
+import { ruby } from './plugins/ruby.js';
+import { sh } from './plugins/sh.js';
+import { solidity } from './plugins/solidity.js';
+import { sortJson } from './plugins/sort-json.js';
+import { sql } from './plugins/sql.js';
+import { tailwindcss } from './plugins/tailwindcss.js';
+import { xml } from './plugins/xml.js';
+import { mergeConfigs } from './utils/merge-configs.js';
 
-const DEFAULT_PLUGINS = {
-  'jsdoc': true,
-  'mdc': true,
-  'packagejson': true,
-  'pug': true,
-  'sh': true,
-  'solidity': true,
-  'sort-json': true,
-  'xml': true,
+const DEFAULTS = {
+  bracketSameLine: false,
+  endOfLine: 'lf',
+  objectWrap: 'collapse',
+  proseWrap: 'always',
+  quoteProps: 'consistent',
+  singleAttributePerLine: true,
+  singleQuote: true,
+  tabWidth: 2,
+  trailingComma: 'all',
+  vueIndentScriptAndStyle: true,
 };
 
-const OPTIONAL_PLUGINS = {
-  php: false,
-  ruby: false,
-  sql: false,
-  tailwindcss: false,
-};
-
-const PLUGINS = { ...DEFAULT_PLUGINS, ...OPTIONAL_PLUGINS };
-
 /**
- * Create plugins config list
- *
- * @param {PLUGINS} plugins Enabled/disabled plugins list
- *
- * @returns {import('prettier').Config} Prettier configuration
+ * Фабрики плагинов. Каждый плагин подключается явно: передайте
+ * `plugins.<name>()` в `defineConfig`
  */
-const createPluginsConfig = async (plugins = {}) => {
-  const pluginEntries = Object.entries({ ...PLUGINS, ...plugins });
-
-  const configs = await Promise.all(
-    pluginEntries
-      .filter(([, isActive]) => isActive)
-      .map(async ([name]) => {
-        const { default: config } = await import(
-          `@alexlit/config-prettier/plugins/${name}.js`
-        );
-
-        return config;
-      }),
-  );
-
-  let pluginsConfig = { overrides: [], plugins: [] };
-
-  configs.forEach((config) => {
-    if (config.plugins?.length > 0) {
-      pluginsConfig.plugins.push(...config.plugins);
-    }
-
-    if (config.overrides?.length > 0) {
-      pluginsConfig.overrides.push(...config.overrides);
-    }
-
-    pluginsConfig = {
-      ...pluginsConfig,
-      ...omit(config, ['plugins', 'overrides']),
-    };
-  });
-
-  return pluginsConfig;
+export const plugins = {
+  jsdoc,
+  mdc,
+  packageJson,
+  php,
+  pug,
+  ruby,
+  sh,
+  solidity,
+  sortJson,
+  sql,
+  tailwindcss,
+  xml,
 };
 
 /**
- * Create prettier config
+ * Создать конфигурацию Prettier
+ *
+ * Плагинов по умолчанию нет - подключайте нужные явно:
+ *
+ * ```js
+ * defineConfig(
+ *   [
+ *     plugins.php(),
+ *     plugins.tailwindcss({ tailwindFunctions: ['cn', 'tw'] }),
+ *   ],
+ *   { printWidth: 100 },
+ * );
+ * ```
  *
- * @param {PLUGINS} plugins
- * @param {import('prettier').Config} options Prettier options
+ * Базовые опции заменяются опциями плагинов и `options`. Коллекции `overrides`
+ * и `plugins` дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ * выигрывают.
  *
- * @returns {import('prettier').Config} Prettier configuration
+ * @param {import('prettier').Config[]} pluginConfigs Конфиги плагинов, напр.
+ *   `[plugins.php()]`
+ * @param {import('prettier').Config} options Базовые опции Prettier (наивысший
+ *   приоритет)
+ *
+ * @returns {import('prettier').Config} Конфигурация Prettier
  */
-export const createConfig = async (plugins = {}, options = {}) => {
-  const pluginsConfig = await createPluginsConfig(plugins);
-
-  return {
-    bracketSameLine: false,
-    endOfLine: 'lf',
-    objectWrap: 'collapse',
-    overrides: [
-      ...(pluginsConfig.overrides ?? []),
-      ...(options.overrides ?? []),
-    ],
-    plugins: [...(pluginsConfig.plugins ?? []), ...(options.plugins ?? [])],
-    proseWrap: 'always',
-    quoteProps: 'consistent',
-    singleAttributePerLine: true,
-    singleQuote: true,
-    tabWidth: 2,
-    trailingComma: 'all',
-    vueIndentScriptAndStyle: true,
-
-    ...omit(pluginsConfig, ['plugins']),
-    ...omit(options, ['plugins']),
-  };
-};
+export const defineConfig = (pluginConfigs = [], options = {}) =>
+  mergeConfigs(DEFAULTS, ...pluginConfigs, options);

package/packages/config-prettier/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexlit/config-prettier",
-  "version": "23.3.0",
+  "version": "25.0.0",
   "private": false,
   "description": "prettier config",
   "keywords": [
@@ -23,10 +23,13 @@
   ],
   "type": "module",
   "main": "index.js",
+  "types": "index.d.ts",
   "files": [
     "README.md",
+    "index.d.ts",
     "index.js",
-    "plugins"
+    "plugins",
+    "utils"
   ],
   "scripts": {
     "ou": "../../scripts/ou.sh",
@@ -48,8 +51,7 @@
     "prettier-plugin-solidity": "^2.4.1",
     "prettier-plugin-sort-json": "^4.2.0",
     "prettier-plugin-sql": "^0.20.0",
-    "prettier-plugin-tailwindcss": "^0.8.1",
-    "radash": "^12.1.1"
+    "prettier-plugin-tailwindcss": "^0.8.1"
   },
   "publishConfig": {
     "access": "public",

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

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

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

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

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

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

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

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

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

@@ -1,8 +1,23 @@
-/** @see [plugin-pug](https://github.com/prettier/plugin-pug) */
-export default {
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = {
   plugins: ['@prettier/plugin-pug'],
   pugCommentPreserveSpaces: 'trim-all',
   pugSingleQuote: false,
   pugSortAttributes: 'asc',
   pugWrapAttributesThreshold: 3,
 };
+
+/**
+ * Форматирует Pug-шаблоны с сортировкой атрибутов и одинарными кавычками
+ *
+ * @param {Partial<import('prettier').Config>} [options] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`overrides`, `plugins`)
+ *   дополняются, `plugins` дедуплицируются, более поздние `overrides`
+ *   выигрывают, остальные поля заменяются
+ *
+ * @returns {import('prettier').Config}
+ *
+ * @see [plugin-pug](https://github.com/prettier/plugin-pug)
+ */
+export const pug = (options = {}) => mergeConfigs(DEFAULTS, options);

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] - Опции, накладываемые
+ *   поверх значений по умолчанию. Коллекции (`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 default {
-  overrides: [
-    {
-      files: '*.html.erb',
-      options: {
-        parser: 'eruby-parse',
-      },
-    },
-  ],
-  plugins: ['@prettier/plugin-ruby', 'prettier-plugin-eruby'],
-};
+export const ruby = (options = {}) => mergeConfigs(DEFAULTS, options);

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

@@ -1,4 +1,17 @@
-/** @see [prettier-plugin-sh](https://github.com/astorije/prettier-plugin-sh) */
-export default {
-  plugins: ['prettier-plugin-sh'],
-};
+import { mergeConfigs } from '../utils/merge-configs.js';
+
+const DEFAULTS = { plugins: ['prettier-plugin-sh'] };
+
+/**
+ * Форматирует shell-скрипты
+ *
+ * @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 = {}) => mergeConfigs(DEFAULTS, options);