@nemigo/configs 0.2.2 → 1.1.0

package/dist/eslint/index.d.ts

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

package/dist/{eslint.js → eslint/index.js}

@@ -1,41 +1,45 @@
 import { convertIgnorePatternToMinimatch, includeIgnoreFile } from "@eslint/compat";
 import jslint from "@eslint/js";
-// import prettier from "eslint-config-prettier";
 import { configs as svelteConfigs } from "eslint-plugin-svelte";
-import { defineConfig as eslintDefineConfig } from "eslint/config";
+import { defineConfig } from "eslint/config";
 import globals from "globals";
 import { join } from "node:path";
 import tslint from "typescript-eslint";
 export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
 /**
- * Универсальная сборка flat-конфига для 'eslint'.
+ * Создает готовый flat-конфиг для **ESLint**
  *
  * Включает в себя:
- * - .eslint.ignore
- * - globals
- * - javascript
- * - typescript
- * - prettier (отключён)
- * - svelte (опционально)
+ * - Конфигурацию из `.eslint.ignore`
+ * - Глобальные переменные для браузера и Node.js (globals)
+ * - Рекомендованные правила из `@eslint/js`
+ * - Рекомендованные или strict правила из `typescript-eslint`
+ * - Опционально: конфигурацию для Svelte
+ *
+ * Отключены различные правила TypeScript, которые только мешают.
+ *
+ * @param {EslintConfigOptions} [options] - Опции конфигурации
+ * @param {...ConfigWithExtendsArray} [rest] - Дополнительные конфигурации ESLint для расширения
+ * @returns {Linter.Config[]} Массив flat-конфигов ESLint
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files
  */
-export const defineConfig = (opts, ...rest) => eslintDefineConfig(includeIgnoreFile(opts.ignore || join(import.meta.dirname, "../.eslint.ignore"), "@nemigo/configs/.eslint.ignore"), jslint.configs.recommended, ...(opts.strict
-    ? opts.service
+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
-    : opts.service
+    : options?.service
         ? tslint.configs.recommendedTypeChecked
-        : tslint.configs.recommended), opts.service
+        : tslint.configs.recommended), options?.service
     ? {
         languageOptions: {
             parserOptions: {
                 projectService: true,
-                tsconfigRootDir: opts.service,
+                tsconfigRootDir: options.service,
             },
         },
     }
-    : {}, ...(opts.svelte ? svelteConfigs["flat/recommended"] : []), 
+    : {}, ...(options?.svelte ? svelteConfigs["flat/recommended"] : []), 
 // prettier,
 // ...(svelte ? svelteConfigs["flat/prettier"] : []),
 {
@@ -80,7 +84,7 @@ export const defineConfig = (opts, ...rest) => eslintDefineConfig(includeIgnoreF
         "@typescript-eslint/restrict-template-expressions": 0,
         "no-import-assign": 0,
     },
-}, opts.svelte
+}, options?.svelte
     ? {
         files: [
             "**/*.svelte",
@@ -92,7 +96,7 @@ export const defineConfig = (opts, ...rest) => eslintDefineConfig(includeIgnoreF
                 projectService: true,
                 extraFileExtensions: [".svelte"],
                 parser: tslint.parser,
-                svelteConfig: opts.svelte,
+                svelteConfig: options?.svelte,
             },
         },
         rules: {

package/dist/{eslint.types.d.ts → 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

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { defineEslintConfig, convertIgnorePattern, includeIgnoreFile } from "./eslint/index.js";
+export { definePrettierConfig, pretty } from "./prettier/index.js";
+export { defineSvelteConfig } from "./svelte/index.js";
+export { defineSveltePackageConfig } from "./svelte/package.js";
+export { defineViteConfig } from "./vite/index.js";
+export { defineViteProxyConfig } from "./vite/proxy.js";
+export type * from "./types.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+export { defineEslintConfig, convertIgnorePattern, includeIgnoreFile } from "./eslint/index.js";
+export { definePrettierConfig, pretty } from "./prettier/index.js";
+export { defineSvelteConfig } from "./svelte/index.js";
+export { defineSveltePackageConfig } from "./svelte/package.js";
+export { defineViteConfig } from "./vite/index.js";
+export { defineViteProxyConfig } from "./vite/proxy.js";

package/dist/prettier/index.d.ts

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

package/dist/prettier/index.js

@@ -0,0 +1,85 @@
+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**
+ *
+ * Включает в себя плагины:
+ * - `prettier-plugin-svelte` - поддержка Svelte
+ * - `prettier-plugin-css-order` - сортировка CSS свойств
+ * - `prettier-plugin-multiline-arrays` - форматирование массивов
+ * - `prettier-plugin-tailwindcss` - сортировка классов Tailwind CSS
+ *
+ * Основные настройки:
+ * - Ширина таба: 2 пробела
+ * - Использование табов: true
+ * - Ширина строки: 150 символов
+ * - Двойные кавычки
+ * - Запятые в конце (es5)
+ * - Теги в одной строке с элементами
+ *
+ * @param {PrettierConfigOptions} [options] - Опции конфигурации
+ * @returns {PrettierConfig} Готовый конфиг Prettier
+ *
+ * @see https://prettier.io
+ */
+export const definePrettierConfig = (options) => ({
+    tabWidth: 2,
+    useTabs: true,
+    printWidth: 150,
+    singleQuote: false,
+    trailingComma: "es5",
+    bracketSameLine: true,
+    experimentalTernaries: false,
+    multilineArraysWrapThreshold: options?.arraysWrapThreshold ?? 3,
+    plugins: [
+        svelte,
+        css,
+        arrays,
+        tailwind,
+    ],
+    overrides: [
+        {
+            files: "*.svelte",
+            options: { parser: "svelte" },
+        },
+    ],
+    tailwindStylesheet: options?.tailwind?.stylesheet,
+    ...(options?.overload ?? {}),
+});
+const config = definePrettierConfig();
+/**
+ * Форматирование кода с помощью **Prettier** используя конфиг из {@link definePrettierConfig}
+ *
+ * @example
+ * ```typescript
+ * // Форматирование TypeScript кода
+ * const formatted = await pretty(`const x=1`, 'typescript');
+ *
+ * // Форматирование Svelte компонента
+ * const formatted = await pretty(`<div>hello</div>`, 'svelte');
+ *
+ * // Форматирование с кастомными опциями
+ * const formatted = await pretty(`const x=1`, 'typescript', {
+ *   arraysWrapThreshold: 5,
+ *   tailwind: { stylesheet: './src/tailwind.css' }
+ * });
+ * ```
+ *
+ * @param {string} content - Исходный код для форматирования
+ * @param {Options["parser"]} 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?.overload ?? {}),
+});

package/dist/svelte/index.d.ts

@@ -1,17 +1,22 @@
 import type { Adapter, Config } from "@sveltejs/kit";
+/**
+ * Опции конфигурации для {@link defineSvelteConfig}
+ */
 export interface SvelteConfigOptions {
     /**
      * Адаптер серверной платформы
      *
+     * @alias Config.kit.adapter
      * @see https://svelte.dev/docs/kit/adapters
      */
     adapter: Adapter;
     /**
      * Только руны
      *
-     * @see https://svelte.dev/docs/svelte/what-are-runes
-     *
      * @default true
+     *
+     * @alias Config.compilerOptions.runes
+     * @see https://svelte.dev/docs/svelte/what-are-runes
      */
     runes?: boolean;
     /**
@@ -19,47 +24,75 @@ 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
-     *
-     * @default `true`
      */
     csrfCheckOrigin?: boolean;
     /**
      * Алиасы путей
      *
-     * @default {}
+     * @alias Config.kit.alias
+     * @see https://svelte.dev/docs/kit/configuration#alias
      */
     alias?: Record<string, string>;
     /**
-     * Переопледеление путей кита
+     * Переопределение путей кита
+     *
+     * @see https://svelte.dev/docs/kit/configuration#files
      */
     files?: {
         /**
-         * @default "./static"
+         * Путь к директории со статическими файлами
+         *
+         * @alias Config.kit.files.assets
+         * @see https://svelte.dev/docs/kit/configuration#files
          */
         assets?: string;
         /**
-         * @default "./src/app.html"
+         * Путь к главному `app.html` приложения
+         *
+         * @alias Config.kit.files.appTemplate
+         * @see https://svelte.dev/docs/kit/configuration#files
          */
         app_html?: string;
         /**
-         * @default "./src/error.html"
+         * Путь к `error.html` приложения
+         *
+         * @alias Config.kit.files.errorTemplate
+         * @see https://svelte.dev/docs/kit/configuration#files
          */
         error_html?: string;
     };
     /**
-     * Глобусы исключений из tsconfig-а
+     * Глобусы включений для tsconfig-а
+     *
+     * @alias Config.kit.typescript.config.include
+     * @see @https://svelte.dev/docs/kit/configuration#typescript
+     * @see https://www.typescriptlang.org/tsconfig/#include
      */
-    exclude?: string[];
+    include?: string[];
     /**
-     * Глобусы включений из tsconfig-а
+     * Глобусы исключений для tsconfig-а
+     *
+     * @alias Config.kit.typescript.config.exclude
+     * @see @https://svelte.dev/docs/kit/configuration#typescript
+     * @see https://www.typescriptlang.org/tsconfig/#exclude
      */
-    include?: string[];
+    exclude?: string[];
 }
 /**
- * Конфиг для приложений на `@sveltejs/kit`
+ * Реструктурированная конфигурация приложений на **SvelteKit**
+ *
+ * - По умолчанию **только** руны
+ * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte)
+ * - Иная конфигурация tsconfig-а
+ *
+ * @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
  */
-export declare const defineConfig: (options: SvelteConfigOptions) => Config;
+export declare const defineSvelteConfig: (options: SvelteConfigOptions) => Config;

package/dist/svelte/index.js

@@ -5,11 +5,20 @@ 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)
+ * - Иная конфигурация tsconfig-а
+ *
+ * @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
  */
-export const defineConfig = (options) => ({
+export const defineSvelteConfig = (options) => ({
     /**
      * Настройки поведения svelte-компилятора
      *
@@ -25,7 +34,7 @@ export const defineConfig = (options) => ({
     /**
      * Расширение поддержки всякого в svelte (в т.ч. и полной для typescript)
      *
-     * @see https://svelte.dev/docs/kit/integrations
+     * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
      */
     preprocess: vitePreprocess({ script: true }),
     kit: {
@@ -63,7 +72,6 @@ export const defineConfig = (options) => ({
                     resolveJsonModule: true,
                     skipLibCheck: true,
                     disableSizeLimit: true,
-                    erasableSyntaxOnly: true,
                 };
                 config["exclude"] = setifyArray([
                     ...getOptionalArray(config["exclude"]),
@@ -76,7 +84,11 @@ export const defineConfig = (options) => ({
                     "../scripts",
                     "../types",
                     "../*.ts",
+                    "../*.mts",
+                    "../*.cts",
                     "../*.js",
+                    "../*.mjs",
+                    "../*.cjs",
                     ...(options.include ?? []),
                 ]);
                 return config;

package/dist/svelte/package.d.ts

@@ -1,24 +1,50 @@
 import type { Config } from "@sveltejs/kit";
+/**
+ * Опции конфигурации для {@link defineSveltePackageConfig}
+ */
 export interface SveltePackageConfigOptions {
     /**
      * Только руны
      *
-     * @see https://svelte.dev/docs/svelte/what-are-runes
-     *
      * @default true
+     * @alias Config.compilerOptions.runes
+     * @see https://svelte.dev/docs/svelte/what-are-runes
      */
     runes?: boolean;
     /**
      * Добавляет алиас `{ "#": "src" }`
      *
      * @default true
+     * @alias Config.kit.alias
+     * @see https://svelte.dev/docs/kit/configuration#alias
      */
     isolate?: boolean;
     /**
      * Алиасы путей
      *
-     * @default {}
+     * @alias Config.kit.alias
+     * @see https://svelte.dev/docs/kit/configuration#alias
      */
     alias?: Record<string, string>;
+    /**
+     * Путь, который транспилер будет считать корневым для пакета
+     *
+     * @default "./src"
+     * @alias Config.kit.files.lib
+     * @see https://svelte.dev/docs/kit/configuration#files
+     */
+    path?: string;
 }
-export declare const definePackageConfig: ({ runes, isolate, alias }?: SveltePackageConfigOptions) => Config;
+/**
+ * Реструктурированная конфигурация для **@sveltejs/package**
+ *
+ * - По умолчанию **только** руны.
+ * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).
+ * - По умолчанию иной путь к пакету ("./src/lib" -> "./src")
+ *
+ * @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,14 +1,26 @@
 import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
-export const definePackageConfig = ({ runes = true, isolate = true, alias = {} } = {}) => ({
+/**
+ * Реструктурированная конфигурация для **@sveltejs/package**
+ *
+ * - По умолчанию **только** руны.
+ * - Подключён VitePreprocess (@sveltejs/vite-plugin-svelte).
+ * - По умолчанию иной путь к пакету ("./src/lib" -> "./src")
+ *
+ * @param {SveltePackageConfigOptions} [options]
+ * @returns {Config}
+ * @see https://svelte.dev/docs/kit/packaging
+ * @see https://svelte.dev/docs/kit/integrations#vitePreprocess
+ */
+export const defineSveltePackageConfig = (options) => ({
     /**
      * Настройки поведения svelte-компилятора
      *
      * @see https://svelte.dev/docs/svelte/svelte-compiler#CompileOptions
      */
     compilerOptions: {
-        runes,
+        runes: options?.runes ?? true,
         /**
-         * Использование современного AST
+         * Использование современного AST (не знаю, на что влияет)
          */
         modernAst: true,
     },
@@ -21,13 +33,13 @@ export const definePackageConfig = ({ runes = true, isolate = true, alias = {} }
     kit: {
         files: {
             /**
-             * Путь к библиотеке
+             * Путь, который сборщик будет корневым считать для пакета
              */
-            lib: "src",
+            lib: options?.path ?? "./src",
         },
         alias: {
-            ...(isolate ? { "#": "src" } : {}),
-            ...alias,
+            ...(!options?.isolate ? {} : { "#": "src" }),
+            ...(options?.alias ?? {}),
         },
     },
 });

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+export type { EslintConfigOptions } from "./eslint/index.js";
+export type { ConfigWithExtendsArray } from "./eslint/types.js";
+export type { PrettierConfigOptions, PrettierConfig } 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";
+export type { ViteProxyConfigOptions } from "./vite/proxy.js";

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/vite/index.d.ts

@@ -1,9 +1,17 @@
 import type { BuildOptions, PluginOption, ServerOptions } from "vite";
 import type { ViteUserConfig } from "vitest/config";
 /**
- * Настройка конфигурации для {@link defineConfig}
+ * Опции конфигурации для {@link defineViteConfig}
  */
 export interface ViteConfigOptions {
+    /**
+     * Путь к директории, где читает .env-файлы. Отключено, так как предполагается использование **dotenv**
+     *
+     * @default false
+     * @alias ViteUserConfig.envDir
+     * @see https://vite.dev/config/shared-options.html#envdir
+     */
+    env?: string | false;
     /**
      * Порт приложения
      *
@@ -17,7 +25,7 @@ export interface ViteConfigOptions {
      */
     offStrictPort?: boolean;
     /**
-     * Конфигурация минификации при сборке
+     * Минификация при сборке
      *
      * @see https://vite.dev/config/build-options.html#build-minify
      */
@@ -42,9 +50,18 @@ export interface ViteConfigOptions {
     plugins?: PluginOption[];
 }
 /**
- * Реструктурированная конфигурация `vite` через `vitest`
+ * Реструктурированная конфигурация для **Vite** через **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
  */
-export declare const defineConfig: (options?: ViteConfigOptions, test?: ViteUserConfig["test"]) => ViteUserConfig;
+export declare const defineViteConfig: (options?: ViteConfigOptions, test?: ViteUserConfig["test"]) => ViteUserConfig;

package/dist/vite/index.js

@@ -1,17 +1,21 @@
-import { defineConfig as defineVitestConfig } from "vitest/config";
+import { defineConfig } from "vitest/config";
 /**
- * Реструктурированная конфигурация `vite` через `vitest`
+ * Реструктурированная конфигурация для **Vite** через **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
  */
-export const defineConfig = (options = {}, test) => defineVitestConfig({
-    /**
-     * Где смотрит .env-файлы. Отключено, т.к. файлы читаются через dotenv
-     *
-     * @see https://vite.dev/config/shared-options.html#envdir
-     */
-    envDir: false,
+export const defineViteConfig = (options, test) => defineConfig({
+    envDir: options?.env,
     /**
      * Префикс публичных env-переменных (чтобы совпадало с svelte-kit)
      *
@@ -24,16 +28,16 @@ export const defineConfig = (options = {}, test) => defineVitestConfig({
      * @see https://vite.dev/config/server-options.html
      */
     server: {
-        port: options.port,
+        port: options?.port,
         /**
          * Выдаёт ошибку, если порт занят
          *
          * @see https://vite.dev/config/server-options.html#server-strictport
          */
-        strictPort: !options.offStrictPort,
-        proxy: options.proxy,
+        strictPort: !options?.offStrictPort,
+        proxy: options?.proxy,
         fs: {
-            allow: options.allow,
+            allow: options?.allow,
         },
     },
     /**
@@ -42,9 +46,9 @@ export const defineConfig = (options = {}, test) => defineVitestConfig({
      * @see https://vite.dev/config/build-options.html
      */
     build: {
-        minify: options.minify,
+        minify: options?.minify,
     },
-    plugins: options.plugins,
+    plugins: options?.plugins,
     /**
      * Конфигурация `vitest`
      *
@@ -52,10 +56,10 @@ export const defineConfig = (options = {}, test) => defineVitestConfig({
      */
     test: test ?? {
         /**
-         * glob-путь к файлам тестов
+         * Glob-путь к файлам тестов
          *
          * @see https://vitest.dev/config/#include
          */
-        include: ["src/**/*.{test,spec}.{ts,js}"],
+        include: ["./src/**/*.{test,spec}.{ts,js}"],
     },
 });

package/dist/vite/proxy.d.ts

@@ -1,18 +1,18 @@
 import type { ServerOptions } from "vite";
 /**
- * Настройка конфигурации для {@link defineProxyConfig}
+ * Опции конфигурации для {@link defineViteProxyConfig}
  */
 export interface ViteProxyConfigOptions {
     /**
      * URL-адрес сервера, на который будет направляться прокси
      *
-     * @example `http://localhost:3000`
+     * @example http://localhost:3000
      */
     domain: string;
     /**
      * Префикс маршрута, который будет перенаправляться.
      *
-     * @example `/api/`
+     * @example /api/
      */
     prefix: string;
     /**
@@ -23,8 +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 defineProxyConfig: ({ domain: target, prefix, changeOrigin }: ViteProxyConfigOptions) => ServerOptions["proxy"];
+export declare const defineViteProxyConfig: (options: ViteProxyConfigOptions) => ServerOptions["proxy"];

package/dist/vite/proxy.js

@@ -1,15 +1,36 @@
 /**
- * Создания прокси-конфига для 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 defineProxyConfig = ({ domain: target, prefix, changeOrigin = true }) => {
+export const defineViteProxyConfig = (options) => {
     const pad = (v) => v.toString().padStart(2, "0");
     const now = new Date();
     const hours = pad(now.getHours());
     const mins = pad(now.getMinutes());
     const secs = pad(now.getSeconds());
     const PROXY = "\x1b[1m\x1b[96m[PROXY]\x1b[0m\x1b[22m";
-    console.log(`${hours}:${mins}:${secs} ${PROXY} ${target} \n`);
-    return { [prefix]: { target, changeOrigin } };
+    console.log(`${hours}:${mins}:${secs} ${PROXY} ${options.domain} \n`);
+    return {
+        [options.prefix]: {
+            target: options.domain,
+            changeOrigin: options.changeOrigin ?? true,
+        },
+    };
 };

package/package.json

@@ -1,12 +1,15 @@
 {
 	"name": "@nemigo/configs",
-	"version": "0.2.2",
+	"version": "1.1.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
 		"email": "vlad.logvin84@gmail.com"
 	},
 	"type": "module",
+	"engines": {
+		"node": ">=22"
+	},
 	"scripts": {
 		"build": "svelte-package && rimraf .svelte-kit",
 		"format": "prettier --write ./"
@@ -17,20 +20,24 @@
 		"typescript.json"
 	],
 	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		},
 		"./.eslint.ignore": {
 			"default": "./.eslint.ignore"
 		},
 		"./eslint": {
-			"types": "./dist/eslint.d.ts",
-			"default": "./dist/eslint.js"
+			"types": "./dist/eslint/index.d.ts",
+			"default": "./dist/eslint/index.js"
 		},
 		"./eslint/types": {
 			"types": "./dist/eslint/types.d.ts",
 			"default": "./dist/eslint/types.js"
 		},
 		"./prettier": {
-			"types": "./dist/prettier.d.ts",
-			"default": "./dist/prettier.js"
+			"types": "./dist/prettier/index.d.ts",
+			"default": "./dist/prettier/index.js"
 		},
 		"./svelte": {
 			"types": "./dist/svelte/index.d.ts",
@@ -40,8 +47,9 @@
 			"types": "./dist/svelte/package.d.ts",
 			"default": "./dist/svelte/package.js"
 		},
-		"./typescript.json": {
-			"default": "./typescript.json"
+		"./types": {
+			"types": "./dist/types.d.ts",
+			"default": "./dist/types.js"
 		},
 		"./vite": {
 			"types": "./dist/vite/index.d.ts",
@@ -50,6 +58,9 @@
 		"./vite/proxy": {
 			"types": "./dist/vite/proxy.d.ts",
 			"default": "./dist/vite/proxy.js"
+		},
+		"./typescript.json": {
+			"default": "./typescript.json"
 		}
 	},
 	"peerDependencies": {
@@ -71,13 +82,12 @@
 		"@eslint/compat": "1.4.0",
 		"@eslint/js": "9.37.0",
 		"@types/eslint": "9.6.1",
-		"eslint-config-prettier": "10.1.8",
 		"eslint-plugin-svelte": "3.12.4",
 		"globals": "16.4.0",
 		"prettier-plugin-css-order": "2.1.2",
 		"prettier-plugin-multiline-arrays": "4.0.3",
 		"prettier-plugin-svelte": "3.4.0",
-		"prettier-plugin-tailwindcss": "0.6.14",
-		"typescript-eslint": "8.46.0"
+		"prettier-plugin-tailwindcss": "0.7.0",
+		"typescript-eslint": "8.46.1"
 	}
 }

package/dist/eslint.d.ts

@@ -1,37 +0,0 @@
-import { convertIgnorePatternToMinimatch, includeIgnoreFile } from "@eslint/compat";
-import type { Config } from "@sveltejs/kit";
-import type { Linter } from "eslint";
-import type { ConfigWithExtendsArray } from "./eslint.types.js";
-export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
-export interface EslintConfigOptions {
-    /**
-     * Конфиг свелта для его линтига
-     */
-    svelte?: Config;
-    /**
-     * Использование strict-правил tslint
-     */
-    strict?: boolean;
-    /**
-     * Путь к проекту (`import.meta.dirname`) для более сложного линтинга типов (TypeChecked)
-     */
-    service?: string;
-    /**
-     * Путь к иному .eslint.ignore
-     */
-    ignore?: string;
-}
-/**
- * Универсальная сборка flat-конфига для 'eslint'.
- *
- * Включает в себя:
- * - .eslint.ignore
- * - globals
- * - javascript
- * - typescript
- * - prettier (отключён)
- * - svelte (опционально)
- *
- * @see https://eslint.org/docs/latest/use/configure/configuration-files
- */
-export declare const defineConfig: (opts: EslintConfigOptions, ...rest: ConfigWithExtendsArray) => Linter.Config[];

package/dist/eslint.types.js

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

package/dist/prettier.d.ts

@@ -1,13 +0,0 @@
-import type { Config, Options } from "prettier";
-/**
- * @param tailwindStylesheet - путь к конфигу Tailwind V4 (`./src/tailwind.css`)
- */
-export declare const defineConfig: (tailwindStylesheet?: string) => Config;
-/**
- * Форматирование с помощью *prettier*
- *
- * @param content - содержимое
- * @param parser - какой парсер
- * @param tailwindStylesheet - путь к конфигу Tailwind V4 (ex. `./src/tailwind.css`)
- */
-export declare const pretty: (content: string, parser: Options["parser"], tailwindStylesheet?: string) => Promise<string>;

package/dist/prettier.js

@@ -1,42 +0,0 @@
-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";
-/**
- * @param tailwindStylesheet - путь к конфигу Tailwind V4 (`./src/tailwind.css`)
- */
-export const defineConfig = (tailwindStylesheet) => ({
-    tabWidth: 2,
-    useTabs: true,
-    printWidth: 150,
-    singleQuote: false,
-    trailingComma: "es5",
-    bracketSameLine: true,
-    experimentalTernaries: false,
-    multilineArraysWrapThreshold: 3,
-    plugins: [
-        svelte,
-        css,
-        arrays,
-        tailwind,
-    ],
-    overrides: [
-        {
-            files: "*.svelte",
-            options: { parser: "svelte" },
-        },
-    ],
-    tailwindStylesheet,
-});
-//...
-const config = defineConfig();
-/**
- * Форматирование с помощью *prettier*
- *
- * @param content - содержимое
- * @param parser - какой парсер
- * @param tailwindStylesheet - путь к конфигу Tailwind V4 (ex. `./src/tailwind.css`)
- */
-export const pretty = (content, parser, tailwindStylesheet) => format(content, { ...config, parser, tailwindStylesheet });