@nemigo/configs 1.3.0 → 1.4.0

package/dist/eslint/index.d.ts

@@ -1,55 +1,70 @@
+import type { ConfigWithExtendsArray } from "../types.js";
 import { convertIgnorePatternToMinimatch, includeIgnoreFile } from "@eslint/compat";
 import type { Config } from "@sveltejs/kit";
 import type { Linter } from "eslint";
-import type { ConfigWithExtendsArray } from "./types.js";
 export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
 /**
- * Опции конфигурации для {@link defineEslintConfig}
+ * Опции создания конфигураций для {@link defineEslintConfig}
  */
 export interface EslintConfigOptions {
     /**
-     * Конфиг Svelte для его линтинга
-     *
-     * @see https://sveltejs.github.io/eslint-plugin-svelte
+     * Конфиг {@link https://svelte.dev/docs/kit/configuration Svelte} для его линтинга с помощью {@link https://sveltejs.github.io/eslint-plugin-svelte eslint-plugin-svelte}
      */
     svelte?: Config;
     /**
-     * Использование strict-правил typescript-eslint
-     *
-     * @default false
-     * @see https://typescript-eslint.io/users/configs/#strict
+     * Использование {@link https://typescript-eslint.io/users/configs/#strict strict-правил} из {@link https://typescript-eslint.io typescript-eslint}
      */
     strict?: boolean;
     /**
-     * Путь к проекту (`import.meta.dirname`) для typed-linting
+     * Путь к проекту для {@link https://typescript-eslint.io/getting-started/typed-linting typed-linting} из {@link https://typescript-eslint.io typescript-eslint}
      *
-     * @see https://typescript-eslint.io/getting-started/typed-linting
+     * @example
+     * ```typescript
+     * import.meta.dirname
+     * ```
      */
     service?: string;
     /**
-     * Путь к альтернативному файлу `.eslint.ignore`
-     *
-     * @see https://github.com/eslint/rewrite/tree/main/packages/compat#readme
+     * Путь к иному файлу для {@link includeIgnoreFile} из {@link https://www.npmjs.com/package/@eslint/compat @eslint/compat}
      */
     ignore?: string;
 }
 /**
- * Создает готовый flat-конфиг для **ESLint**
+ * ## Создает flat-конфигурации для {@link https://eslint.org ESLint}
+ *
+ * ### Включает в себя:
+ * - Глобусы исключений из **.eslint.ignore** пакета (или иного файла) с помощью {@link includeIgnoreFile} из {@link https://www.npmjs.com/package/@eslint/compat @eslint/compat}
+ * - Глобалы из {@link https://www.npmjs.com/package/globals globals}
+ * - Рекомендованные правила из {@link https://www.npmjs.com/package/@eslint/js @eslint/js}
+ * - Рекомендованные (или strict) правила из {@link https://typescript-eslint.io typescript-eslint}
+ * - **Отключение** различных правил из {@link https://typescript-eslint.io typescript-eslint} и {@link https://sveltejs.github.io/eslint-plugin-svelte eslint-plugin-svelte}, которые обычно только мешают
+ *
+ * ### Опционально:
+ * - Линтинг для {@link https://svelte.dev Svelte} с помощью {@link https://sveltejs.github.io/eslint-plugin-svelte eslint-plugin-svelte}
+ * - Сервис {@link https://typescript-eslint.io/getting-started/typed-linting typed-linting} для {@link https://typescript-eslint.io typescript-eslint}
+ *
+ * ---
  *
- * Включает в себя:
- * - Глобусы исключений из `.eslint.ignore` пакета или иного
- * - Глобальные переменные для браузера и Node.js (globals)
- * - Рекомендованные правила из `@eslint/js`
- * - Рекомендованные или strict правила из `typescript-eslint`
- * - Опционально: конфигурацию для Svelte
- * - Опционально: typed-linting из `typescript-eslint`
+ * @example
+ * ```typescript
+ * import { defineEslintConfig } from "@nemigo/configs";
  *
- * Отключены различные правила TypeScript, которые только мешают.
+ * export default defineEslintConfig({
+ * 	strict: true,
+ * 	service: import.meta.dirname,
+ * });
+ * ```
  *
- * @param {EslintConfigOptions} [options] - Опции конфигурации
- * @param {...ConfigWithExtendsArray} [rest] - Дополнительные конфигурации ESLint для расширения
- * @returns {Linter.Config[]} Массив flat-конфигов ESLint
+ * @example
+ * ```typescript
+ * import { defineEslintConfig } from "@nemigo/configs";
+ * import svelte from "./svelte.config.js";
  *
- * @see https://eslint.org/docs/latest/use/configure/configuration-files
+ * export default defineEslintConfig({
+ * 	svelte,
+ * 	strict: true,
+ * 	service: import.meta.dirname,
+ * });
+ * ```
  */
 export declare const defineEslintConfig: (options?: EslintConfigOptions, ...rest: ConfigWithExtendsArray) => Linter.Config[];

package/dist/eslint/index.js

@@ -7,23 +7,42 @@ import { join } from "node:path";
 import tslint from "typescript-eslint";
 export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
 /**
- * Создает готовый flat-конфиг для **ESLint**
+ * ## Создает flat-конфигурации для {@link https://eslint.org ESLint}
  *
- * Включает в себя:
- * - Глобусы исключений из `.eslint.ignore` пакета или иного
- * - Глобальные переменные для браузера и Node.js (globals)
- * - Рекомендованные правила из `@eslint/js`
- * - Рекомендованные или strict правила из `typescript-eslint`
- * - Опционально: конфигурацию для Svelte
- * - Опционально: typed-linting из `typescript-eslint`
+ * ### Включает в себя:
+ * - Глобусы исключений из **.eslint.ignore** пакета (или иного файла) с помощью {@link includeIgnoreFile} из {@link https://www.npmjs.com/package/@eslint/compat @eslint/compat}
+ * - Глобалы из {@link https://www.npmjs.com/package/globals globals}
+ * - Рекомендованные правила из {@link https://www.npmjs.com/package/@eslint/js @eslint/js}
+ * - Рекомендованные (или strict) правила из {@link https://typescript-eslint.io typescript-eslint}
+ * - **Отключение** различных правил из {@link https://typescript-eslint.io typescript-eslint} и {@link https://sveltejs.github.io/eslint-plugin-svelte eslint-plugin-svelte}, которые обычно только мешают
  *
- * Отключены различные правила TypeScript, которые только мешают.
+ * ### Опционально:
+ * - Линтинг для {@link https://svelte.dev Svelte} с помощью {@link https://sveltejs.github.io/eslint-plugin-svelte eslint-plugin-svelte}
+ * - Сервис {@link https://typescript-eslint.io/getting-started/typed-linting typed-linting} для {@link https://typescript-eslint.io typescript-eslint}
  *
- * @param {EslintConfigOptions} [options] - Опции конфигурации
- * @param {...ConfigWithExtendsArray} [rest] - Дополнительные конфигурации ESLint для расширения
- * @returns {Linter.Config[]} Массив flat-конфигов ESLint
+ * ---
  *
- * @see https://eslint.org/docs/latest/use/configure/configuration-files
+ * @example
+ * ```typescript
+ * import { defineEslintConfig } from "@nemigo/configs";
+ *
+ * export default defineEslintConfig({
+ * 	strict: true,
+ * 	service: import.meta.dirname,
+ * });
+ * ```
+ *
+ * @example
+ * ```typescript
+ * import { defineEslintConfig } from "@nemigo/configs";
+ * import svelte from "./svelte.config.js";
+ *
+ * export default defineEslintConfig({
+ * 	svelte,
+ * 	strict: true,
+ * 	service: import.meta.dirname,
+ * });
+ * ```
  */
 export const defineEslintConfig = (options, ...rest) => {
     const acc = [];

package/dist/eslint/types.d.ts

@@ -6,7 +6,8 @@ export interface ConfigWithExtends extends Linter.Config {
     extends?: ExtendsElement[];
 }
 /**
- * Взято из @eslint/config-helpers/types (0.3.1), т.к. нужный тип (ConfigWithExtendsArray) не экспортируется пакетом.
- * Представляется собой массив flat-конфигов ESLint
+ * Массив конфигов для {@link defineConfig} из {@link https://www.npmjs.com/package/eslint/config eslint/config}
+ *
+ * @remarks Взято из {@link https://www.npmjs.com/package/@eslint/config-helpers @eslint/config-helpers/types (0.3.1)}, т.к. этот тип не экспортируется
  */
 export type ConfigWithExtendsArray = InfiniteArray<ConfigWithExtends>[];

package/dist/prettier/index.d.ts

@@ -1,68 +1,87 @@
-import type { Config, Options } from "prettier";
+import type { Config as PrettierConfig, Options } from "prettier";
+import type { CssOrderPrettierConfig } from "prettier-plugin-css-order";
 import type { MultilineArrayOptions } from "prettier-plugin-multiline-arrays";
-import type { PluginConfig as SveltePrettier } from "prettier-plugin-svelte";
-import type { PluginOptions as TailwindPrettier } from "prettier-plugin-tailwindcss";
+import type { PluginConfig as SveltePrettierConfig } from "prettier-plugin-svelte";
+import type { PluginOptions as TailwindPrettierConfig } from "prettier-plugin-tailwindcss";
+export type { PrettierConfig };
+export type { SveltePrettierConfig };
+export type { CssOrderPrettierConfig };
+export type MultilineArrayPrettierConfig = Partial<MultilineArrayOptions>;
+export type { TailwindPrettierConfig };
 /**
- * Объединенный тип конфигурации `prettier`, включающий настройки всех используемых плагинов
+ * ## Тип конфигурации из {@link definePrettierConfig}
+ *
+ * ### Включает в себя:
+ * - {@link PrettierConfig} самого {@link https://prettier.io Prettier}
+ * - {@link SveltePrettierConfig} для {@link https://www.npmjs.com/package/prettier-plugin-svelte prettier-plugin-svelte}
+ * - {@link CssOrderPrettierConfig} для {@link https://www.npmjs.com/package/prettier-plugin-css-order prettier-plugin-css-order}
+ * - {@link MultilineArrayPrettierConfig} для {@link https://www.npmjs.com/package/prettier-plugin-multiline-arrays prettier-plugin-multiline-arrays}
+ * - {@link TailwindPrettierConfig} для {@link https://www.npmjs.com/package/prettier-plugin-tailwindcss prettier-plugin-tailwindcss}
  */
-export type PrettierConfig = TailwindPrettier & Config & Partial<MultilineArrayOptions> & SveltePrettier;
+export type PrettierExtraConfig = PrettierConfig & SveltePrettierConfig & CssOrderPrettierConfig & MultilineArrayPrettierConfig & TailwindPrettierConfig;
 /**
- * Опции конфигурации для {@link definePrettierConfig}
+ * Опции создания конфигурации для {@link definePrettierConfig}
  */
 export interface PrettierConfigOptions {
     /**
-     * Порог длины для переноса массивов
+     * Порог длины для разбиения массивов для {@link https://www.npmjs.com/package/prettier-plugin-multiline-arrays prettier-plugin-multiline-arrays}
      *
-     * @default 3
-     * @alias MultilineArrayOptions.multilineArraysWrapThreshold
+     * Аналог к {@link MultilineArrayOptions.multilineArraysWrapThreshold}
      *
-     * @see https://www.npmjs.com/package/prettier-plugin-multiline-arrays
+     * @default 3
      */
     arraysWrapThreshold?: number;
     /**
-     * Дополнительные настройки для `prettier-plugin-tailwindcss`
-     *
-     * @see https://www.npmjs.com/package/prettier-plugin-tailwindcss
+     * Реструктурированная конфигурация для {@link https://www.npmjs.com/package/prettier-plugin-tailwindcss prettier-plugin-tailwindcss}
      */
     tailwind?: {
         /**
-         * Путь к конфигу Tailwind V4 (например, `./src/tailwind.css`)
+         * Путь к конфигу {@link https://tailwindcss.com Tailwind CSS V4} для {@link https://www.npmjs.com/package/prettier-plugin-tailwindcss prettier-plugin-tailwindcss}
+         *
+         * Аналог к {@link TailwindPrettierConfig.tailwindStylesheet}
          *
-         * @alias TailwindPrettier.tailwindStylesheet
-         * @see https://www.npmjs.com/package/prettier-plugin-tailwindcss
+         * @example
+         * ```typescript
+         * "./src/tailwind.css"
+         * ```
          */
         stylesheet?: string;
     };
     /**
-     * Переопределение конфига Prettier
+     * Переопределение создаваемого конфига
      */
-    overload?: PrettierConfig;
+    overload?: PrettierExtraConfig;
 }
 /**
- * Создает готовый конфиг для **Prettier**
+ * ## Создает готовый конфиг для {@link https://prettier.io Prettier}
  *
- * Включает в себя плагины:
- * - `prettier-plugin-svelte` - поддержка Svelte
- * - `prettier-plugin-css-order` - сортировка CSS свойств
- * - `prettier-plugin-multiline-arrays` - форматирование массивов
- * - `prettier-plugin-tailwindcss` - сортировка классов Tailwind CSS
+ * ### Включает в себя плагины:
+ * - {@link https://www.npmjs.com/package/prettier-plugin-svelte prettier-plugin-svelte} для {@link https://svelte.dev Svelte}
+ * - {@link https://www.npmjs.com/package/prettier-plugin-css-order prettier-plugin-css-order} для сортировки CSS-свойств
+ * - {@link https://www.npmjs.com/package/prettier-plugin-multiline-arrays prettier-plugin-multiline-arrays} для массивов
+ * - {@link https://www.npmjs.com/package/prettier-plugin-tailwindcss prettier-plugin-tailwindcss} для сортировки классов {@link https://tailwindcss.com Tailwind CSS}
  *
- * Основные настройки:
- * - Ширина таба: 2 пробела
- * - Использование табов: true
- * - Ширина строки: 150 символов
- * - Двойные кавычки
- * - Запятые в конце (es5)
- * - Теги в одной строке с элементами
+ * ### Используемые настройки:
+ * - Ширина таба в 2 пробела ({@link PrettierConfig.tabWidth}: 2)
+ * - Использование табов: ({@link PrettierConfig.useTabs}: true)
+ * - Ширина строки в 150 символов ({@link PrettierConfig.printWidth}: 150)
+ * - Двойные кавычки ({@link PrettierConfig.singleQuote}: false)
+ * - Запятые в конце ({@link PrettierConfig.trailingComma}: es5)
+ * - Теги в одной строке с элементами ({@link PrettierConfig.bracketSameLine}: true)
+ * - Разбиение массива с порогом в 3 элемента ({@link MultilineArrayOptions.multilineArraysWrapThreshold}: 3)
  *
- * @param {PrettierConfigOptions} [options] - Опции конфигурации
- * @returns {PrettierConfig} Готовый конфиг Prettier
+ * ---
  *
- * @see https://prettier.io
+ * @example
+ * ```typescript
+ * import { definePrettierConfig } from "@nemigo/configs";
+ *
+ * export default definePrettierConfig();
+ * ```
  */
-export declare const definePrettierConfig: (options?: PrettierConfigOptions) => PrettierConfig;
+export declare const definePrettierConfig: (options?: PrettierConfigOptions) => PrettierExtraConfig;
 /**
- * Форматирование кода с помощью **Prettier** используя конфиг из {@link definePrettierConfig}
+ * Форматирование кода с помощью {@link format} из {@link https://www.npmjs.com/package/prettier prettier} используя конфиг из {@link definePrettierConfig}
  *
  * @example
  * ```typescript
@@ -75,12 +94,5 @@ export declare const definePrettierConfig: (options?: PrettierConfigOptions) =>
  *   tailwind: { stylesheet: './src/tailwind.css' }
  * });
  * ```
- *
- * @param {string} content - Исходный код для форматирования
- * @param {Options["parser"] | "svelte"} parser - Парсер для определения типа кода
- * @param {PrettierConfigOptions} [options] - Дополнительные опции конфигурации
- * @returns {Promise<string>} Отформатированный код
- *
- * @see https://prettier.io/docs/api#format
  */
 export declare const pretty: (content: string, parser: Options["parser"] | "svelte", options?: PrettierConfigOptions) => Promise<string>;

package/dist/prettier/index.js

@@ -1,30 +1,34 @@
 import { format } from "prettier";
-// noinspection TypeScriptCheckImport (у пакета нет типов)
 import * as css from "prettier-plugin-css-order";
 import * as arrays from "prettier-plugin-multiline-arrays";
 import * as svelte from "prettier-plugin-svelte";
 import * as tailwind from "prettier-plugin-tailwindcss";
 /**
- * Создает готовый конфиг для **Prettier**
+ * ## Создает готовый конфиг для {@link https://prettier.io Prettier}
  *
- * Включает в себя плагины:
- * - `prettier-plugin-svelte` - поддержка Svelte
- * - `prettier-plugin-css-order` - сортировка CSS свойств
- * - `prettier-plugin-multiline-arrays` - форматирование массивов
- * - `prettier-plugin-tailwindcss` - сортировка классов Tailwind CSS
+ * ### Включает в себя плагины:
+ * - {@link https://www.npmjs.com/package/prettier-plugin-svelte prettier-plugin-svelte} для {@link https://svelte.dev Svelte}
+ * - {@link https://www.npmjs.com/package/prettier-plugin-css-order prettier-plugin-css-order} для сортировки CSS-свойств
+ * - {@link https://www.npmjs.com/package/prettier-plugin-multiline-arrays prettier-plugin-multiline-arrays} для массивов
+ * - {@link https://www.npmjs.com/package/prettier-plugin-tailwindcss prettier-plugin-tailwindcss} для сортировки классов {@link https://tailwindcss.com Tailwind CSS}
  *
- * Основные настройки:
- * - Ширина таба: 2 пробела
- * - Использование табов: true
- * - Ширина строки: 150 символов
- * - Двойные кавычки
- * - Запятые в конце (es5)
- * - Теги в одной строке с элементами
+ * ### Используемые настройки:
+ * - Ширина таба в 2 пробела ({@link PrettierConfig.tabWidth}: 2)
+ * - Использование табов: ({@link PrettierConfig.useTabs}: true)
+ * - Ширина строки в 150 символов ({@link PrettierConfig.printWidth}: 150)
+ * - Двойные кавычки ({@link PrettierConfig.singleQuote}: false)
+ * - Запятые в конце ({@link PrettierConfig.trailingComma}: es5)
+ * - Теги в одной строке с элементами ({@link PrettierConfig.bracketSameLine}: true)
+ * - Разбиение массива с порогом в 3 элемента ({@link MultilineArrayOptions.multilineArraysWrapThreshold}: 3)
  *
- * @param {PrettierConfigOptions} [options] - Опции конфигурации
- * @returns {PrettierConfig} Готовый конфиг Prettier
+ * ---
  *
- * @see https://prettier.io
+ * @example
+ * ```typescript
+ * import { definePrettierConfig } from "@nemigo/configs";
+ *
+ * export default definePrettierConfig();
+ * ```
  */
 export const definePrettierConfig = (options) => ({
     tabWidth: 2,
@@ -33,7 +37,6 @@ export const definePrettierConfig = (options) => ({
     singleQuote: false,
     trailingComma: "es5",
     bracketSameLine: true,
-    experimentalTernaries: false,
     multilineArraysWrapThreshold: options?.arraysWrapThreshold ?? 3,
     plugins: [
         svelte,
@@ -50,9 +53,10 @@ export const definePrettierConfig = (options) => ({
     tailwindStylesheet: options?.tailwind?.stylesheet,
     ...(options?.overload ?? {}),
 });
+//...
 const config = definePrettierConfig();
 /**
- * Форматирование кода с помощью **Prettier** используя конфиг из {@link definePrettierConfig}
+ * Форматирование кода с помощью {@link format} из {@link https://www.npmjs.com/package/prettier prettier} используя конфиг из {@link definePrettierConfig}
  *
  * @example
  * ```typescript
@@ -65,13 +69,6 @@ const config = definePrettierConfig();
  *   tailwind: { stylesheet: './src/tailwind.css' }
  * });
  * ```
- *
- * @param {string} content - Исходный код для форматирования
- * @param {Options["parser"] | "svelte"} parser - Парсер для определения типа кода
- * @param {PrettierConfigOptions} [options] - Дополнительные опции конфигурации
- * @returns {Promise<string>} Отформатированный код
- *
- * @see https://prettier.io/docs/api#format
  */
 export const pretty = (content, parser, options) => format(content, {
     ...config,

package/dist/prettier/plugins/css-order.d.ts

@@ -0,0 +1,32 @@
+declare module "prettier-plugin-css-order" {
+	export interface CssOrderPrettierConfig {
+		/**
+		 * ### Стратегии сортировки CSS-свойств:
+		 * - `"alphabetical"` — сортировка по алфавиту от a до z
+		 * - `"smacss"` — сортировка от наиболее значимых свойств (влияющих на поток и компоновку) к наименее значимым (оформление, детали)
+		 * - `"concentric-css"` — сортировка от внешних аспектов блока (позиционирование, отступы) к внутренним (размеры, оформление, текст)
+		 *
+		 * @default "concentric-css"
+		 */
+		cssDeclarationSorterOrder?: "alphabetical" | "smacss" | "concentric-css";
+		/**
+		 * Сохраняет переопределения свойств (например, `!important`) в исходном порядке, даже если они нарушают стратегию сортировки
+		 *
+		 * @default true
+		 */
+		cssDeclarationSorterKeepOverrides?: boolean;
+		/**
+		 * Пользовательский порядок сортировки CSS-свойств.
+		 * Указывается как массив имён свойств в желаемом порядке
+		 *
+		 * Если задан (и не пуст), полностью заменяет поведение {@link CssOrderPrettierConfig.cssDeclarationSorterOrder}`
+		 *
+		 * @default []
+		 */
+		cssDeclarationSorterCustomOrder?: string[];
+	}
+
+	export default import("prettier").Plugin;
+
+	export = import("prettier").Plugin;
+}

package/dist/svelte/index.d.ts

@@ -1,98 +1,94 @@
 import type { Adapter, Config } from "@sveltejs/kit";
 /**
- * Опции конфигурации для {@link defineSvelteConfig}
+ * Опции создания конфигурации для {@link defineSvelteConfig}
  */
 export interface SvelteConfigOptions {
     /**
-     * Адаптер серверной платформы
+     * {@link https://svelte.dev/docs/kit/adapters Адаптер} серверной платформы для **SvelteKit**
      *
-     * @alias Config.kit.adapter
-     * @see https://svelte.dev/docs/kit/adapters
+     * Аналог к {@link KitConfig.adapter}
      */
     adapter: Adapter;
     /**
-     * Только руны
+     * Только {@link https://svelte.dev/docs/svelte/what-are-runes руны}
      *
-     * @default true
-     * @alias Config.compilerOptions.runes
+     * Аналог к {@link CompileOptions.runes}
      *
-     * @see https://svelte.dev/docs/svelte/what-are-runes
+     * @default true
      */
     runes?: boolean;
     /**
-     * Проверка источника запроса (CSRF-защита)
+     * {@link https://svelte.dev/docs/kit/configuration#alias Алиасы} путей для **SvelteKit** и {@link https://www.npmjs.com/package/@sveltejs/package @sveltejs/package}
      *
-     * Отключить, если нужна возможность обращения с локалки на прод-приложения
-     *
-     * @alias Config.kit.csrf.checkOrigin
-     * @see https://svelte.dev/docs/kit/configuration#csrf
-     * @see https://developer.mozilla.org/en-US/docs/Web/Security/Types_of_attacks#cross-site_request_forgery_csrf
-     */
-    csrfCheckOrigin?: boolean;
-    /**
-     * Алиасы путей
-     *
-     * @alias Config.kit.alias
-     * @see https://svelte.dev/docs/kit/configuration#alias
+     * Аналог к {@link KitConfig.alias}
      */
     alias?: Record<string, string>;
     /**
-     * Переопределение путей кита
+     * Переопределение путей для **SvelteKit**
+     *
+     * Почти аналог к {@link KitConfig.files}
      *
      * @see https://svelte.dev/docs/kit/configuration#files
      */
     files?: {
         /**
-         * Путь к директории со статическими файлами
+         * Путь к директории со статикой для **SvelteKit**
+         *
+         * Аналог к {@link KitConfig.files.assets}
          *
-         * @alias Config.kit.files.assets
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         assets?: string;
         /**
-         * Путь к главному `app.html` приложения
+         * Путь к `app.html` для **SvelteKit**
+         *
+         * Аналог к {@link KitConfig.files.appTemplate}
          *
-         * @alias Config.kit.files.appTemplate
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         app_html?: string;
         /**
-         * Путь к `error.html` приложения
+         * Путь к `error.html` для **SvelteKit**
+         *
+         * Аналог к {@link KitConfig.files.errorTemplate}
          *
-         * @alias Config.kit.files.errorTemplate
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         error_html?: string;
     };
     /**
-     * Глобусы включений для tsconfig-а
+     * {@link https://www.typescriptlang.org/tsconfig/#include Глобусы включений} в **tsconfig** внутри **SvelteKit**
      *
-     * @alias Config.kit.typescript.config.include
-     * @see @https://svelte.dev/docs/kit/configuration#typescript
-     * @see https://www.typescriptlang.org/tsconfig/#include
+     * Использует {@link KitConfig.typescript}
+     *
+     * @see https://svelte.dev/docs/kit/configuration#typescript
      */
     include?: string[];
     /**
-     * Глобусы исключений для tsconfig-а
+     * {@link https://www.typescriptlang.org/tsconfig/#exclude Глобусы исключений} в **tsconfig** внутри **SvelteKit**
+     *
+     * Использует {@link KitConfig.typescript}
      *
-     * @alias Config.kit.typescript.config.exclude
-     * @see @https://svelte.dev/docs/kit/configuration#typescript
-     * @see https://www.typescriptlang.org/tsconfig/#exclude
+     * @see https://svelte.dev/docs/kit/configuration#typescript
      */
     exclude?: string[];
 }
 /**
- * Реструктурированная конфигурация приложений на **SvelteKit**
+ * ## Реструктурированное создание конфигурации для {@link https://svelte.dev/docs/kit/introduction SvelteKit}
+ *
+ * ### Особенности:
+ * - По умолчанию **только** {@link https://svelte.dev/docs/svelte/what-are-runes руны}
+ * - Конфигурация внутреннего {@link https://www.typescriptlang.org/tsconfig tsconfig} аналогичная **typescript.json** пакета
+ * - Подключён {@link vitePreprocess} c `({ script: true })` из {@link https://www.npmjs.com/package/@sveltejs/vite-plugin-svelte @sveltejs/vite-plugin-svelte} для {@link https://svelte.dev/docs/kit/integrations#vitePreprocess расширенной поддержки всякого}
  *
- * - По умолчанию **только** руны
- * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte)
- * - Иная конфигурация tsconfig-а
+ * ---
  *
- * @param {SvelteConfigOptions} options
- * @returns {Config}
+ * @example
+ * ```typescript
+ * import { defineConfig } from "@nemigo/configs/svelte";
+ * import adapter from "@sveltejs/adapter-node";
  *
- * @see https://svelte.dev/docs/kit/introduction
- * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
- * @see https://www.typescriptlang.org/tsconfig
+ * export default defineConfig({ adapter: adapter() });
+ * ```
  */
 export declare const defineSvelteConfig: (options: SvelteConfigOptions) => Config;

package/dist/svelte/index.js

@@ -5,18 +5,22 @@ const getOptionalObject = (value) => (isObject(value) ? value : {});
 const getOptionalArray = (value) => (Array.isArray(value) ? value : []);
 const setifyArray = (array) => Array.from(new Set(array));
 /**
- * Реструктурированная конфигурация приложений на **SvelteKit**
+ * ## Реструктурированное создание конфигурации для {@link https://svelte.dev/docs/kit/introduction SvelteKit}
  *
- * - По умолчанию **только** руны
- * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte)
- * - Иная конфигурация tsconfig-а
+ * ### Особенности:
+ * - По умолчанию **только** {@link https://svelte.dev/docs/svelte/what-are-runes руны}
+ * - Конфигурация внутреннего {@link https://www.typescriptlang.org/tsconfig tsconfig} аналогичная **typescript.json** пакета
+ * - Подключён {@link vitePreprocess} c `({ script: true })` из {@link https://www.npmjs.com/package/@sveltejs/vite-plugin-svelte @sveltejs/vite-plugin-svelte} для {@link https://svelte.dev/docs/kit/integrations#vitePreprocess расширенной поддержки всякого}
  *
- * @param {SvelteConfigOptions} options
- * @returns {Config}
+ * ---
  *
- * @see https://svelte.dev/docs/kit/introduction
- * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
- * @see https://www.typescriptlang.org/tsconfig
+ * @example
+ * ```typescript
+ * import { defineConfig } from "@nemigo/configs/svelte";
+ * import adapter from "@sveltejs/adapter-node";
+ *
+ * export default defineConfig({ adapter: adapter() });
+ * ```
  */
 export const defineSvelteConfig = (options) => ({
     /**
@@ -31,17 +35,9 @@ export const defineSvelteConfig = (options) => ({
          */
         modernAst: true,
     },
-    /**
-     * Расширение поддержки всякого в svelte (в т.ч. и полной для typescript)
-     *
-     * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
-     */
     preprocess: vitePreprocess({ script: true }),
     kit: {
         adapter: options.adapter,
-        csrf: {
-            checkOrigin: options.csrfCheckOrigin,
-        },
         alias: options.alias,
         files: {
             assets: options.files?.assets,
@@ -49,7 +45,7 @@ export const defineSvelteConfig = (options) => ({
             errorTemplate: options.files?.error_html,
         },
         /**
-         * Переопределение и дополнения к `tsconfig.json`
+         * Переопределение и дополнения к генерируемому `tsconfig.json`
          *
          * @see https://svelte.dev/docs/kit/configuration#typescript
          */

package/dist/svelte/package.d.ts

@@ -1,53 +1,58 @@
 import type { Config } from "@sveltejs/kit";
 /**
- * Опции конфигурации для {@link defineSveltePackageConfig}
+ * Опции создания конфигурации для {@link defineSveltePackageConfig}
  */
 export interface SveltePackageConfigOptions {
     /**
-     * Только руны
+     * Только {@link https://svelte.dev/docs/svelte/what-are-runes руны}
      *
-     * @default true
-     * @alias Config.compilerOptions.runes
+     * Аналог к {@link CompileOptions.runes}
      *
-     * @see https://svelte.dev/docs/svelte/what-are-runes
+     * @default true
      */
     runes?: boolean;
     /**
-     * Добавляет алиас `{ "#": "src" }`
+     * Добавляет {@link https://svelte.dev/docs/kit/configuration#alias алиас} `({ "#": "src" })`
      *
-     * @default true
-     * @alias Config.kit.alias
+     * Использует {@link KitConfig.alias}
      *
-     * @see https://svelte.dev/docs/kit/configuration#alias
+     * @default true
      */
     isolate?: boolean;
     /**
-     * Алиасы путей
+     * {@link https://svelte.dev/docs/kit/configuration#alias Алиасы} путей
      *
-     * @alias Config.kit.alias
-     * @see https://svelte.dev/docs/kit/configuration#alias
+     * Аналог к {@link KitConfig.alias}
      */
     alias?: Record<string, string>;
     /**
      * Путь, который транспилер будет считать корневым для пакета
      *
+     * Аналог к {@link KitConfig.files.lib}
+     *
      * @default "./src"
-     * @alias Config.kit.files.lib
      *
      * @see https://svelte.dev/docs/kit/configuration#files
      */
     path?: string;
 }
 /**
- * Реструктурированная конфигурация для **@sveltejs/package**
+ * ## Реструктурированное создание конфигурации для транспилера {@link https://www.npmjs.com/package/@sveltejs/package @sveltejs/package}
+ *
+ * ### Особенности:
+ * - По умолчанию **только** {@link https://svelte.dev/docs/svelte/what-are-runes руны}
+ * - По умолчанию иной путь к пакету (`"./src/lib" -> "./src"`)
+ * - Подключён {@link vitePreprocess} c `({ script: true })` из {@link https://www.npmjs.com/package/@sveltejs/vite-plugin-svelte @sveltejs/vite-plugin-svelte} для {@link https://svelte.dev/docs/kit/integrations#vitePreprocess расширенной поддержки всякого}
+ *
+ * ---
+ *
+ * @example
+ * ```typescript
+ * import { defineSveltePackageConfig } from "@nemigo/configs";
  *
- * - По умолчанию **только** руны.
- * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).
- * - По умолчанию иной путь к пакету ("./src/lib" -> "./src")
+ * export default defineSveltePackageConfig();
+ * ```
  *
- * @param {SveltePackageConfigOptions} [options]
- * @returns {Config}
  * @see https://svelte.dev/docs/kit/packaging
- * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
  */
 export declare const defineSveltePackageConfig: (options?: SveltePackageConfigOptions) => Config;

package/dist/svelte/package.js

@@ -1,15 +1,22 @@
 import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
 /**
- * Реструктурированная конфигурация для **@sveltejs/package**
+ * ## Реструктурированное создание конфигурации для транспилера {@link https://www.npmjs.com/package/@sveltejs/package @sveltejs/package}
  *
- * - По умолчанию **только** руны.
- * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).
- * - По умолчанию иной путь к пакету ("./src/lib" -> "./src")
+ * ### Особенности:
+ * - По умолчанию **только** {@link https://svelte.dev/docs/svelte/what-are-runes руны}
+ * - По умолчанию иной путь к пакету (`"./src/lib" -> "./src"`)
+ * - Подключён {@link vitePreprocess} c `({ script: true })` из {@link https://www.npmjs.com/package/@sveltejs/vite-plugin-svelte @sveltejs/vite-plugin-svelte} для {@link https://svelte.dev/docs/kit/integrations#vitePreprocess расширенной поддержки всякого}
+ *
+ * ---
+ *
+ * @example
+ * ```typescript
+ * import { defineSveltePackageConfig } from "@nemigo/configs";
+ *
+ * export default defineSveltePackageConfig();
+ * ```
  *
- * @param {SveltePackageConfigOptions} [options]
- * @returns {Config}
  * @see https://svelte.dev/docs/kit/packaging
- * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
  */
 export const defineSveltePackageConfig = (options) => ({
     /**
@@ -24,17 +31,9 @@ export const defineSveltePackageConfig = (options) => ({
          */
         modernAst: true,
     },
-    /**
-     * Расширение поддержки всякого в svelte (в т.ч. и полной для typescript)
-     *
-     * @see https://svelte.dev/docs/kit/integrations
-     */
     preprocess: vitePreprocess({ script: true }),
     kit: {
         files: {
-            /**
-             * Путь, который сборщик будет корневым считать для пакета
-             */
             lib: options?.path ?? "./src",
         },
         alias: {

package/dist/types.d.ts

@@ -1,6 +1,6 @@
 export type { EslintConfigOptions } from "./eslint/index.js";
 export type { ConfigWithExtendsArray } from "./eslint/types.js";
-export type { PrettierConfigOptions, PrettierConfig } from "./prettier/index.js";
+export type { PrettierConfigOptions, PrettierExtraConfig, MultilineArrayPrettierConfig, CssOrderPrettierConfig, SveltePrettierConfig, PrettierConfig, TailwindPrettierConfig, } from "./prettier/index.js";
 export type { SvelteConfigOptions } from "./svelte/index.js";
 export type { SveltePackageConfigOptions } from "./svelte/package.js";
 export type { ViteConfigOptions } from "./vite/index.js";

package/dist/vite/index.d.ts

@@ -1,14 +1,15 @@
 import type { BuildOptions, PluginOption, ServerOptions } from "vite";
 import type { ViteUserConfig } from "vitest/config";
 /**
- * Опции конфигурации для {@link defineViteConfig}
+ * Опции создания конфигурации для {@link defineViteConfig}
  */
 export interface ViteConfigOptions {
     /**
      * Путь к директории, где читает .env-файлы. Отключено, так как предполагается использование **dotenv**
      *
+     * Аналог к {@link ViteUserConfig.envDir}
+     *
      * @default false
-     * @alias ViteUserConfig.envDir
      *
      * @see https://vite.dev/config/shared-options.html#envdir
      */
@@ -51,18 +52,12 @@ export interface ViteConfigOptions {
     plugins?: PluginOption[];
 }
 /**
- * Реструктурированная конфигурация для **Vite** через **Vitest**
- *
- * - По умолчанию отключено чтение env-файлов Vite (предполагается использование **dotenv**)
- * - Префикс "PUBLIC_" для публичных env-переменных
- * - Строгая конфигурация порта сервера по умолчанию
- * - По умолчанию путь к тестам "./src/**_/*.{test,spec}.{ts,js}"
- *
- * @param {ViteConfigOptions} [options]
- * @param {ViteUserConfig["test"]} [test]
- * @returns {ViteUserConfig}
+ * ## Реструктурированная конфигурация для {@link https://vite.dev Vite} через {@link defineConfig} от {@link https://vitest.dev Vitest}
  *
- * @see https://vite.dev/ Документация Vite
- * @see https://vitest.dev/ Документация Vitest
+ * ### Особенности:
+ * - По умолчанию отключено чтение env-файлов (предполагается использование **dotenv**)
+ * - Префикс `"PUBLIC_"` для публичных env-переменных
+ * - По умолчанию строгая конфигурация порта сервера
+ * - По умолчанию путь к тестам `"./src/**\/*.{test,spec}.{ts,js}"`
  */
 export declare const defineViteConfig: (options?: ViteConfigOptions, test?: ViteUserConfig["test"]) => ViteUserConfig;

package/dist/vite/index.js

@@ -1,18 +1,12 @@
 import { defineConfig } from "vitest/config";
 /**
- * Реструктурированная конфигурация для **Vite** через **Vitest**
+ * ## Реструктурированная конфигурация для {@link https://vite.dev Vite} через {@link defineConfig} от {@link https://vitest.dev Vitest}
  *
- * - По умолчанию отключено чтение env-файлов Vite (предполагается использование **dotenv**)
- * - Префикс "PUBLIC_" для публичных env-переменных
- * - Строгая конфигурация порта сервера по умолчанию
- * - По умолчанию путь к тестам "./src/**_/*.{test,spec}.{ts,js}"
- *
- * @param {ViteConfigOptions} [options]
- * @param {ViteUserConfig["test"]} [test]
- * @returns {ViteUserConfig}
- *
- * @see https://vite.dev/ Документация Vite
- * @see https://vitest.dev/ Документация Vitest
+ * ### Особенности:
+ * - По умолчанию отключено чтение env-файлов (предполагается использование **dotenv**)
+ * - Префикс `"PUBLIC_"` для публичных env-переменных
+ * - По умолчанию строгая конфигурация порта сервера
+ * - По умолчанию путь к тестам `"./src/**\/*.{test,spec}.{ts,js}"`
  */
 export const defineViteConfig = (options, test) => defineConfig({
     envDir: options?.env,

package/dist/vite/proxy.d.ts

@@ -1,18 +1,24 @@
 import type { ServerOptions } from "vite";
 /**
- * Опции конфигурации для {@link defineViteProxyConfig}
+ * Опции создания конфигурации для {@link defineViteProxyConfig}
  */
 export interface ViteProxyConfigOptions {
     /**
      * URL-адрес сервера, на который будет направляться прокси
      *
-     * @example http://localhost:3000
+     * @example
+     * ```typescript
+     * "http://localhost:3000"
+     * ```
      */
     domain: string;
     /**
      * Префикс маршрута, который будет перенаправляться.
      *
-     * @example /api/
+     * @example
+     * ```typescript
+     * "/api/"
+     * ```
      */
     prefix: string;
     /**
@@ -23,8 +29,7 @@ export interface ViteProxyConfigOptions {
     changeOrigin?: boolean;
 }
 /**
- * Создания прокси-конфига для **Vite**.
- * Используется для проксирования запросов на основной сервер у приложений
+ * Создание конфигурации для проксирования запросов из {@link https://vite.dev Vite}
  *
  * @example
  * ```typescript
@@ -38,9 +43,6 @@ export interface ViteProxyConfigOptions {
  * });
  * ```
  *
- * @param {ViteProxyConfigOptions} options
- * @returns {ServerOptions["proxy"]}
- *
  * @see https://vite.dev/config/server-options.html#server-proxy
  */
 export declare const defineViteProxyConfig: (options: ViteProxyConfigOptions) => ServerOptions["proxy"];

package/dist/vite/proxy.js

@@ -1,6 +1,5 @@
 /**
- * Создания прокси-конфига для **Vite**.
- * Используется для проксирования запросов на основной сервер у приложений
+ * Создание конфигурации для проксирования запросов из {@link https://vite.dev Vite}
  *
  * @example
  * ```typescript
@@ -14,9 +13,6 @@
  * });
  * ```
  *
- * @param {ViteProxyConfigOptions} options
- * @returns {ServerOptions["proxy"]}
- *
  * @see https://vite.dev/config/server-options.html#server-proxy
  */
 export const defineViteProxyConfig = (options) => {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/configs",
-	"version": "1.3.0",
+	"version": "1.4.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -84,7 +84,7 @@
 		"@eslint/compat": "1.4.0",
 		"@eslint/js": "9.38.0",
 		"@types/eslint": "9.6.1",
-		"eslint-plugin-svelte": "3.12.4",
+		"eslint-plugin-svelte": "3.12.5",
 		"globals": "16.4.0",
 		"prettier-plugin-css-order": "2.1.2",
 		"prettier-plugin-multiline-arrays": "4.0.3",
@@ -93,6 +93,6 @@
 		"typescript-eslint": "8.46.1"
 	},
 	"devDependencies": {
-		"@nemigo/configs": "1.2.2"
+		"@nemigo/configs": "1.3.0"
 	}
 }