@nemigo/configs 1.0.1 → 1.1.1

package/dist/eslint/index.d.ts

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

package/dist/eslint/index.js

@@ -7,102 +7,120 @@ import { join } from "node:path";
 import tslint from "typescript-eslint";
 export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
 /**
- * Готовый flat-конфиг для `eslint`
+ * Создает готовый flat-конфиг для **ESLint**
  *
  * Включает в себя:
+ * - Конфигурацию из `.eslint.ignore` пакета или иного
+ * - Глобальные переменные для браузера и Node.js (globals)
+ * - Рекомендованные правила из `@eslint/js`
+ * - Рекомендованные или strict правила из `typescript-eslint`
+ * - Опционально: конфигурацию для Svelte
+ * - Опционально: typed-linting из `typescript-eslint`
  *
- * - .eslint.ignore
- * - Globals
- * - Javascript
- * - Typescript
- * - Svelte (опционально)
+ * Отключены различные правила TypeScript, которые только мешают.
  *
- * Отключено много раздражающих бессмысленных правил
+ * @param {EslintConfigOptions} [options] - Опции конфигурации
+ * @param {...ConfigWithExtendsArray} [rest] - Дополнительные конфигурации ESLint для расширения
+ * @returns {Linter.Config[]} Массив flat-конфигов ESLint
  *
- * @param {EslintConfigOptions} [options]
- * @param {...ConfigWithExtendsArray} [rest]
- * @returns {Linter.Config[]}
  * @see https://eslint.org/docs/latest/use/configure/configuration-files
  */
-export const defineEslintConfig = (options, ...rest) => defineConfig(includeIgnoreFile(options?.ignore || join(import.meta.dirname, "../../.eslint.ignore"), "@nemigo/configs/.eslint.ignore"), jslint.configs.recommended, ...(options?.strict
-    ? options?.service
-        ? tslint.configs.strictTypeChecked
-        : tslint.configs.strict
-    : options?.service
-        ? tslint.configs.recommendedTypeChecked
-        : tslint.configs.recommended), options?.service
-    ? {
-        languageOptions: {
-            parserOptions: {
-                projectService: true,
-                tsconfigRootDir: options.service,
+export const defineEslintConfig = (options, ...rest) => {
+    const acc = [];
+    acc.push(includeIgnoreFile(options?.ignore || join(import.meta.dirname, "../../.eslint.ignore"), "@nemigo/configs/.eslint.ignore"));
+    acc.push(jslint.configs.recommended);
+    if (options?.strict) {
+        if (options?.service) {
+            acc.push(tslint.configs.strictTypeChecked);
+        }
+        else {
+            acc.push(tslint.configs.strict);
+        }
+    }
+    else {
+        if (options?.service) {
+            acc.push(tslint.configs.recommendedTypeChecked);
+        }
+        else {
+            acc.push(tslint.configs.recommended);
+        }
+    }
+    if (options?.service) {
+        acc.push({
+            languageOptions: {
+                parserOptions: {
+                    projectService: true,
+                    tsconfigRootDir: options.service,
+                },
             },
-        },
+        });
     }
-    : {}, ...(options?.svelte ? svelteConfigs["flat/recommended"] : []), 
-// prettier,
-// ...(svelte ? svelteConfigs["flat/prettier"] : []),
-{
-    languageOptions: {
-        globals: {
-            ...globals.browser,
-            ...globals.node,
-        },
-    },
-    rules: {
-        "@typescript-eslint/no-confusing-void-expression": 0,
-        "@typescript-eslint/no-duplicate-type-constituents": 0,
-        "@typescript-eslint/no-dynamic-delete": 0,
-        "@typescript-eslint/no-empty-object-type": 0,
-        "@typescript-eslint/no-explicit-any": 0,
-        "@typescript-eslint/no-invalid-void-type": 0,
-        "@typescript-eslint/no-non-null-asserted-optional-chain": 0,
-        "@typescript-eslint/no-non-null-assertion": 0,
-        "@typescript-eslint/no-redundant-type-constituents": 0,
-        "@typescript-eslint/no-this-alias": 0,
-        "@typescript-eslint/no-unnecessary-type-parameters": 0,
-        "@typescript-eslint/no-unsafe-argument": 0,
-        "@typescript-eslint/no-unsafe-assignment": 0,
-        "@typescript-eslint/no-unsafe-call": 0,
-        "@typescript-eslint/no-unsafe-function-type": 0,
-        "@typescript-eslint/no-unsafe-member-access": 0,
-        "@typescript-eslint/no-unsafe-return": 0,
-        "@typescript-eslint/no-unused-expressions": 0,
-        "@typescript-eslint/no-unused-vars": [
-            "error",
-            {
-                args: "all",
-                argsIgnorePattern: "^_",
-                caughtErrors: "all",
-                caughtErrorsIgnorePattern: "^_",
-                destructuredArrayIgnorePattern: "^_",
-                varsIgnorePattern: "^_",
-                ignoreRestSiblings: true,
+    if (options?.svelte) {
+        acc.push(svelteConfigs["flat/recommended"]);
+        acc.push({
+            files: [
+                "**/*.svelte",
+                "**/*.svelte.ts",
+                "**/*.svelte.js",
+            ],
+            languageOptions: {
+                parserOptions: {
+                    projectService: true,
+                    extraFileExtensions: [".svelte"],
+                    parser: tslint.parser,
+                    svelteConfig: options?.svelte,
+                },
+            },
+            rules: {
+                "svelte/no-at-html-tags": 0,
+                "svelte/no-navigation-without-resolve": 0,
+                "svelte/prefer-svelte-reactivity": 0,
             },
-        ],
-        "@typescript-eslint/restrict-plus-operands": 0,
-        "@typescript-eslint/restrict-template-expressions": 0,
-        "no-import-assign": 0,
-    },
-}, options?.svelte
-    ? {
-        files: [
-            "**/*.svelte",
-            "**/*.svelte.ts",
-            "**/*.svelte.js",
-        ],
+        });
+    }
+    acc.push({
         languageOptions: {
-            parserOptions: {
-                projectService: true,
-                extraFileExtensions: [".svelte"],
-                parser: tslint.parser,
-                svelteConfig: options?.svelte,
+            globals: {
+                ...globals.browser,
+                ...globals.node,
             },
         },
         rules: {
-            "svelte/no-at-html-tags": 0,
-            "svelte/no-navigation-without-resolve": 0,
-            "svelte/prefer-svelte-reactivity": 0,
+            "@typescript-eslint/no-confusing-void-expression": 0,
+            "@typescript-eslint/no-duplicate-type-constituents": 0,
+            "@typescript-eslint/no-dynamic-delete": 0,
+            "@typescript-eslint/no-empty-object-type": 0,
+            "@typescript-eslint/no-explicit-any": 0,
+            "@typescript-eslint/no-invalid-void-type": 0,
+            "@typescript-eslint/no-non-null-asserted-optional-chain": 0,
+            "@typescript-eslint/no-non-null-assertion": 0,
+            "@typescript-eslint/no-redundant-type-constituents": 0,
+            "@typescript-eslint/no-this-alias": 0,
+            "@typescript-eslint/no-unnecessary-type-parameters": 0,
+            "@typescript-eslint/no-unsafe-argument": 0,
+            "@typescript-eslint/no-unsafe-assignment": 0,
+            "@typescript-eslint/no-unsafe-call": 0,
+            "@typescript-eslint/no-unsafe-function-type": 0,
+            "@typescript-eslint/no-unsafe-member-access": 0,
+            "@typescript-eslint/no-unsafe-return": 0,
+            "@typescript-eslint/no-unused-expressions": 0,
+            "@typescript-eslint/no-unused-vars": [
+                "error",
+                {
+                    args: "all",
+                    argsIgnorePattern: "^_",
+                    caughtErrors: "all",
+                    caughtErrorsIgnorePattern: "^_",
+                    destructuredArrayIgnorePattern: "^_",
+                    varsIgnorePattern: "^_",
+                    ignoreRestSiblings: true,
+                },
+            ],
+            "@typescript-eslint/restrict-plus-operands": 0,
+            "@typescript-eslint/restrict-template-expressions": 0,
+            "no-import-assign": 0,
         },
-    }
-    : {}, ...rest);
+    });
+    acc.push(...rest);
+    return defineConfig(acc);
+};

package/dist/eslint/types.d.ts

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

package/dist/eslint/types.js

@@ -1,2 +1 @@
-// Взято из @eslint/config-helpers/types (0.3.1), т.к. нужный тип (ConfigWithExtendsArray) не экспортируется пакетом
 export {};

package/dist/prettier/index.d.ts

@@ -1,9 +1,11 @@
 import type { Config, Options } from "prettier";
-import type { Options as JSDocPrettier } from "prettier-plugin-jsdoc";
 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";
-export type PrettierConfig = TailwindPrettier & Config & JSDocPrettier & Partial<MultilineArrayOptions> & SveltePrettier;
+/**
+ * Объединенный тип конфигурации `prettier`, включающий настройки всех используемых плагинов
+ */
+export type PrettierConfig = TailwindPrettier & Config & Partial<MultilineArrayOptions> & SveltePrettier;
 /**
  * Опции конфигурации для {@link definePrettierConfig}
  */
@@ -12,7 +14,6 @@ export interface PrettierConfigOptions {
      * Порог длины для переноса массивов
      *
      * @default 3
-     *
      * @alias MultilineArrayOptions.multilineArraysWrapThreshold
      *
      * @see https://www.npmjs.com/package/prettier-plugin-multiline-arrays
@@ -23,52 +24,63 @@ export interface PrettierConfigOptions {
      *
      * @see https://www.npmjs.com/package/prettier-plugin-tailwindcss
      */
-    tailwind: {
+    tailwind?: {
         /**
-         * Путь к конфигу Tailwind V4 (`./src/tailwind.css`)
+         * Путь к конфигу Tailwind V4 (например, `./src/tailwind.css`)
          *
          * @alias TailwindPrettier.tailwindStylesheet
-         *
          * @see https://www.npmjs.com/package/prettier-plugin-tailwindcss
          */
         stylesheet?: string;
     };
     /**
-     * Переопределение конфига
-     *
-     * @see https://prettier.io/docs/options
-     * @see https://www.npmjs.com/package/prettier-plugin-tailwindcss
+     * Переопределение конфига Prettier
      */
-    override?: PrettierConfig;
+    overload?: PrettierConfig;
 }
 /**
- * Готовый конфиг для `prettier`
+ * Создает готовый конфиг для **Prettier**
  *
  * Включает в себя плагины:
+ * - `prettier-plugin-svelte` - поддержка Svelte
+ * - `prettier-plugin-css-order` - сортировка CSS свойств
+ * - `prettier-plugin-multiline-arrays` - форматирование массивов
+ * - `prettier-plugin-tailwindcss` - сортировка классов Tailwind CSS
  *
- * - Prettier-plugin-svelte
- * - Prettier-plugin-css-order
- * - Prettier-plugin-multiline-arrays
- * - Prettier-plugin-jsdoc
- * - Prettier-plugin-tailwindcss
- *
- * Используются:
- *
- * - Табы длинной 2
+ * Основные настройки:
+ * - Ширина таба: 2 пробела
+ * - Использование табов: true
+ * - Ширина строки: 150 символов
  * - Двойные кавычки
+ * - Запятые в конце (es5)
+ * - Теги в одной строке с элементами
+ *
+ * @param {PrettierConfigOptions} [options] - Опции конфигурации
+ * @returns {PrettierConfig} Готовый конфиг Prettier
  *
- * @param {PrettierConfigOptions} [options]
- * @returns {PrettierConfig}
  * @see https://prettier.io
  */
 export declare const definePrettierConfig: (options?: PrettierConfigOptions) => PrettierConfig;
 /**
- * Форматирование с помощью `prettier` по сборке из {@link definePrettierConfig}
+ * Форматирование кода с помощью **Prettier** используя конфиг из {@link definePrettierConfig}
  *
- * @param {string} content
- * @param {Options["parser"]} parser
- * @param {PrettierConfigOptions} [options]
- * @returns {Promise<string>}
- * @see https://prettier.io
+ * @example
+ * ```typescript
+ * // Форматирование TypeScript кода
+ * const formatted = await pretty(`const x=1`, 'typescript');
+ *
+ * // Форматирование Svelte-компонента с кастомными опциями
+ * const formatted = await pretty(`<div class="bg-red-500 border border-blue-700">hello</div>`, 'svelte', {
+ *   arraysWrapThreshold: 5,
+ *   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"], options?: PrettierConfigOptions) => Promise<string>;
+export declare const pretty: (content: string, parser: Options["parser"] | "svelte", options?: PrettierConfigOptions) => Promise<string>;

package/dist/prettier/index.js

@@ -1,28 +1,29 @@
 import { format } from "prettier";
 // noinspection TypeScriptCheckImport (у пакета нет типов)
 import * as css from "prettier-plugin-css-order";
-import * as jsdoc from "prettier-plugin-jsdoc";
 import * as arrays from "prettier-plugin-multiline-arrays";
 import * as svelte from "prettier-plugin-svelte";
 import * as tailwind from "prettier-plugin-tailwindcss";
 /**
- * Готовый конфиг для `prettier`
+ * Создает готовый конфиг для **Prettier**
  *
  * Включает в себя плагины:
+ * - `prettier-plugin-svelte` - поддержка Svelte
+ * - `prettier-plugin-css-order` - сортировка CSS свойств
+ * - `prettier-plugin-multiline-arrays` - форматирование массивов
+ * - `prettier-plugin-tailwindcss` - сортировка классов Tailwind CSS
  *
- * - Prettier-plugin-svelte
- * - Prettier-plugin-css-order
- * - Prettier-plugin-multiline-arrays
- * - Prettier-plugin-jsdoc
- * - Prettier-plugin-tailwindcss
- *
- * Используются:
- *
- * - Табы длинной 2
+ * Основные настройки:
+ * - Ширина таба: 2 пробела
+ * - Использование табов: true
+ * - Ширина строки: 150 символов
  * - Двойные кавычки
+ * - Запятые в конце (es5)
+ * - Теги в одной строке с элементами
+ *
+ * @param {PrettierConfigOptions} [options] - Опции конфигурации
+ * @returns {PrettierConfig} Готовый конфиг Prettier
  *
- * @param {PrettierConfigOptions} [options]
- * @returns {PrettierConfig}
  * @see https://prettier.io
  */
 export const definePrettierConfig = (options) => ({
@@ -38,7 +39,6 @@ export const definePrettierConfig = (options) => ({
         svelte,
         css,
         arrays,
-        jsdoc,
         tailwind,
     ],
     overrides: [
@@ -47,26 +47,36 @@ export const definePrettierConfig = (options) => ({
             options: { parser: "svelte" },
         },
     ],
-    tsdoc: true,
-    tailwindStylesheet: options?.tailwind.stylesheet,
-    jsdocCommentLineStrategy: "multiline",
-    ...(options?.override ?? {}),
+    tailwindStylesheet: options?.tailwind?.stylesheet,
+    ...(options?.overload ?? {}),
 });
-//...
 const config = definePrettierConfig();
 /**
- * Форматирование с помощью `prettier` по сборке из {@link definePrettierConfig}
+ * Форматирование кода с помощью **Prettier** используя конфиг из {@link definePrettierConfig}
  *
- * @param {string} content
- * @param {Options["parser"]} parser
- * @param {PrettierConfigOptions} [options]
- * @returns {Promise<string>}
- * @see https://prettier.io
+ * @example
+ * ```typescript
+ * // Форматирование TypeScript кода
+ * const formatted = await pretty(`const x=1`, 'typescript');
+ *
+ * // Форматирование Svelte-компонента с кастомными опциями
+ * const formatted = await pretty(`<div class="bg-red-500 border border-blue-700">hello</div>`, 'svelte', {
+ *   arraysWrapThreshold: 5,
+ *   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,
     parser,
     multilineArraysWrapThreshold: options?.arraysWrapThreshold ?? 3,
-    tailwindStylesheet: options?.tailwind.stylesheet,
-    ...(options?.override ?? {}),
+    tailwindStylesheet: options?.tailwind?.stylesheet,
+    ...(options?.overload ?? {}),
 });

package/dist/svelte/index.d.ts

@@ -7,7 +7,6 @@ export interface SvelteConfigOptions {
      * Адаптер серверной платформы
      *
      * @alias Config.kit.adapter
-     *
      * @see https://svelte.dev/docs/kit/adapters
      */
     adapter: Adapter;
@@ -15,7 +14,6 @@ export interface SvelteConfigOptions {
      * Только руны
      *
      * @default true
-     *
      * @alias Config.compilerOptions.runes
      *
      * @see https://svelte.dev/docs/svelte/what-are-runes
@@ -27,7 +25,6 @@ export interface SvelteConfigOptions {
      * Отключить, если нужна возможность обращения с локалки на прод-приложения
      *
      * @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
      */
@@ -36,7 +33,6 @@ export interface SvelteConfigOptions {
      * Алиасы путей
      *
      * @alias Config.kit.alias
-     *
      * @see https://svelte.dev/docs/kit/configuration#alias
      */
     alias?: Record<string, string>;
@@ -50,7 +46,6 @@ export interface SvelteConfigOptions {
          * Путь к директории со статическими файлами
          *
          * @alias Config.kit.files.assets
-         *
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         assets?: string;
@@ -58,7 +53,6 @@ export interface SvelteConfigOptions {
          * Путь к главному `app.html` приложения
          *
          * @alias Config.kit.files.appTemplate
-         *
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         app_html?: string;
@@ -66,7 +60,6 @@ export interface SvelteConfigOptions {
          * Путь к `error.html` приложения
          *
          * @alias Config.kit.files.errorTemplate
-         *
          * @see https://svelte.dev/docs/kit/configuration#files
          */
         error_html?: string;
@@ -75,7 +68,6 @@ export interface SvelteConfigOptions {
      * Глобусы включений для tsconfig-а
      *
      * @alias Config.kit.typescript.config.include
-     *
      * @see @https://svelte.dev/docs/kit/configuration#typescript
      * @see https://www.typescriptlang.org/tsconfig/#include
      */
@@ -84,14 +76,13 @@ export interface SvelteConfigOptions {
      * Глобусы исключений для tsconfig-а
      *
      * @alias Config.kit.typescript.config.exclude
-     *
      * @see @https://svelte.dev/docs/kit/configuration#typescript
      * @see https://www.typescriptlang.org/tsconfig/#exclude
      */
     exclude?: string[];
 }
 /**
- * Реструктурированная конфигурация приложений на `@sveltejs/kit`
+ * Реструктурированная конфигурация приложений на **SvelteKit**
  *
  * - По умолчанию **только** руны
  * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte)
@@ -99,6 +90,7 @@ export interface SvelteConfigOptions {
  *
  * @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

package/dist/svelte/index.js

@@ -5,7 +5,7 @@ const getOptionalObject = (value) => (isObject(value) ? value : {});
 const getOptionalArray = (value) => (Array.isArray(value) ? value : []);
 const setifyArray = (array) => Array.from(new Set(array));
 /**
- * Реструктурированная конфигурация приложений на `@sveltejs/kit`
+ * Реструктурированная конфигурация приложений на **SvelteKit**
  *
  * - По умолчанию **только** руны
  * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte)
@@ -13,6 +13,7 @@ const setifyArray = (array) => Array.from(new Set(array));
  *
  * @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

package/dist/svelte/package.d.ts

@@ -7,7 +7,6 @@ export interface SveltePackageConfigOptions {
      * Только руны
      *
      * @default true
-     *
      * @alias Config.compilerOptions.runes
      *
      * @see https://svelte.dev/docs/svelte/what-are-runes
@@ -17,7 +16,6 @@ export interface SveltePackageConfigOptions {
      * Добавляет алиас `{ "#": "src" }`
      *
      * @default true
-     *
      * @alias Config.kit.alias
      *
      * @see https://svelte.dev/docs/kit/configuration#alias
@@ -27,7 +25,6 @@ export interface SveltePackageConfigOptions {
      * Алиасы путей
      *
      * @alias Config.kit.alias
-     *
      * @see https://svelte.dev/docs/kit/configuration#alias
      */
     alias?: Record<string, string>;
@@ -42,7 +39,7 @@ export interface SveltePackageConfigOptions {
     path?: string;
 }
 /**
- * Реструктурированная конфигурация для `@sveltejs/package`
+ * Реструктурированная конфигурация для **@sveltejs/package**
  *
  * - По умолчанию **только** руны.
  * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).

package/dist/svelte/package.js

@@ -1,6 +1,6 @@
 import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
 /**
- * Реструктурированная конфигурация для `@sveltejs/package`
+ * Реструктурированная конфигурация для **@sveltejs/package**
  *
  * - По умолчанию **только** руны.
  * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).
@@ -38,7 +38,7 @@ export const defineSveltePackageConfig = (options) => ({
             lib: options?.path ?? "./src",
         },
         alias: {
-            ...(options?.isolate ? { "#": "src" } : {}),
+            ...(!options?.isolate ? {} : { "#": "src" }),
             ...(options?.alias ?? {}),
         },
     },

package/dist/vite/index.d.ts

@@ -5,10 +5,9 @@ import type { ViteUserConfig } from "vitest/config";
  */
 export interface ViteConfigOptions {
     /**
-     * Путь к директории, где читает .env-файлы. Отключено, т.к. файлы читаются через dotenv
+     * Путь к директории, где читает .env-файлы. Отключено, так как предполагается использование **dotenv**
      *
      * @default false
-     *
      * @alias ViteUserConfig.envDir
      *
      * @see https://vite.dev/config/shared-options.html#envdir
@@ -52,16 +51,17 @@ export interface ViteConfigOptions {
     plugins?: PluginOption[];
 }
 /**
- * Реструктурированная конфигурация для `vite` через `vitest`
+ * Реструктурированная конфигурация для **Vite** через **Vitest**
  *
- * - По умолчанию отключено чтение env-файлов
- * - "PUBLIC_" префикс для публичных env-переменных
- * - Строгая конфигурация порта сервера
+ * - По умолчанию отключено чтение 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
  */

package/dist/vite/index.js

@@ -1,15 +1,16 @@
 import { defineConfig } from "vitest/config";
 /**
- * Реструктурированная конфигурация для `vite` через `vitest`
+ * Реструктурированная конфигурация для **Vite** через **Vitest**
  *
- * - По умолчанию отключено чтение env-файлов
- * - "PUBLIC_" префикс для публичных env-переменных
- * - Строгая конфигурация порта сервера
+ * - По умолчанию отключено чтение 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
  */

package/dist/vite/proxy.d.ts

@@ -23,12 +23,24 @@ export interface ViteProxyConfigOptions {
     changeOrigin?: boolean;
 }
 /**
- * Создания прокси-конфига для `vite`
- *
+ * Создания прокси-конфига для **Vite**.
  * Используется для проксирования запросов на основной сервер у приложений
  *
+ * @example
+ * ```typescript
+ * export default defineConfig({
+ *   server: {
+ *     proxy: defineViteProxyConfig({
+ *       domain: "http://localhost:3000",
+ *       prefix: "/api"
+ *     })
+ *   }
+ * });
+ * ```
+ *
  * @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,10 +1,22 @@
 /**
- * Создания прокси-конфига для `vite`
- *
+ * Создания прокси-конфига для **Vite**.
  * Используется для проксирования запросов на основной сервер у приложений
  *
+ * @example
+ * ```typescript
+ * export default defineConfig({
+ *   server: {
+ *     proxy: defineViteProxyConfig({
+ *       domain: "http://localhost:3000",
+ *       prefix: "/api"
+ *     })
+ *   }
+ * });
+ * ```
+ *
  * @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.0.1",
+	"version": "1.1.1",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -80,15 +80,14 @@
 	},
 	"dependencies": {
 		"@eslint/compat": "1.4.0",
-		"@eslint/js": "9.37.0",
+		"@eslint/js": "9.38.0",
 		"@types/eslint": "9.6.1",
 		"eslint-plugin-svelte": "3.12.4",
 		"globals": "16.4.0",
 		"prettier-plugin-css-order": "2.1.2",
-		"prettier-plugin-jsdoc": "1.3.3",
 		"prettier-plugin-multiline-arrays": "4.0.3",
 		"prettier-plugin-svelte": "3.4.0",
-		"prettier-plugin-tailwindcss": "0.7.0",
+		"prettier-plugin-tailwindcss": "0.7.1",
 		"typescript-eslint": "8.46.1"
 	}
 }