@nemigo/configs 0.0.4 → 0.2.0

package/dist/eslint.d.ts

@@ -1,13 +1,26 @@
-import { includeIgnoreFile } from "@eslint/compat";
+import { convertIgnorePatternToMinimatch, includeIgnoreFile } from "@eslint/compat";
 import type { Config } from "@sveltejs/kit";
-import type { ConfigArray, InfiniteDepthConfigWithExtends } from "typescript-eslint";
+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;
-    ignore?: false | string;
+    /**
+     * Путь к иному .eslint.ignore
+     */
+    ignore?: string;
 }
-export { includeIgnoreFile };
 /**
  * Универсальная сборка flat-конфига для 'eslint'.
  *
@@ -21,4 +34,4 @@ export { includeIgnoreFile };
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files
  */
-export declare const defineConfig: ({ ignore, svelte, service, strict }?: EslintConfigOptions, ...other: InfiniteDepthConfigWithExtends[]) => ConfigArray;
+export declare const defineConfig: (opts: EslintConfigOptions, ...rest: ConfigWithExtendsArray) => Linter.Config[];

package/dist/eslint.js

@@ -1,11 +1,12 @@
-import { includeIgnoreFile } from "@eslint/compat";
+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 globals from "globals";
 import { join } from "node:path";
 import tslint from "typescript-eslint";
-export { includeIgnoreFile };
+export { includeIgnoreFile, convertIgnorePatternToMinimatch as convertIgnorePattern };
 /**
  * Универсальная сборка flat-конфига для 'eslint'.
  *
@@ -19,53 +20,31 @@ export { includeIgnoreFile };
  *
  * @see https://eslint.org/docs/latest/use/configure/configuration-files
  */
-export const defineConfig = ({ ignore, svelte, service, strict } = {}, ...other) => tslint.config(ignore === false ? {} : includeIgnoreFile(ignore || join(import.meta.dirname, "../.eslint.ignore")), jslint.configs.recommended, ...(strict
-    ? service
+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
         ? tslint.configs.strictTypeChecked
         : tslint.configs.strict
-    : service
+    : opts.service
         ? tslint.configs.recommendedTypeChecked
-        : tslint.configs.recommended), ...(svelte ? svelteConfigs["flat/recommended"] : []), 
-// prettier,
-// ...(svelte ? svelteConfigs["flat/prettier"] : []),
-service
+        : tslint.configs.recommended), opts.service
     ? {
         languageOptions: {
             parserOptions: {
                 projectService: true,
-                tsconfigRootDir: service,
+                tsconfigRootDir: opts.service,
             },
         },
     }
-    : {}, {
+    : {}, ...(opts.svelte ? svelteConfigs["flat/recommended"] : []), 
+// prettier,
+// ...(svelte ? svelteConfigs["flat/prettier"] : []),
+{
     languageOptions: {
         globals: {
             ...globals.browser,
             ...globals.node,
         },
     },
-}, svelte
-    ? {
-        files: [
-            "./**/*.svelte",
-            "./**/*.svelte.{ts,js}",
-            "./**/*.svelte.{test,spec}.{ts,js}",
-        ],
-        languageOptions: {
-            parserOptions: {
-                projectService: true,
-                extraFileExtensions: [".svelte"],
-                parser: tslint.parser,
-                svelteConfig: svelte,
-            },
-        },
-        rules: {
-            "svelte/no-at-html-tags": 0,
-            "svelte/no-navigation-without-resolve": 0,
-            "svelte/prefer-svelte-reactivity": 0,
-        },
-    }
-    : {}, {
     rules: {
         "@typescript-eslint/no-confusing-void-expression": 0,
         "@typescript-eslint/no-duplicate-type-constituents": 0,
@@ -101,4 +80,25 @@ service
         "@typescript-eslint/restrict-template-expressions": 0,
         "no-import-assign": 0,
     },
-}, ...other);
+}, opts.svelte
+    ? {
+        files: [
+            "**/*.svelte",
+            "**/*.svelte.ts",
+            "**/*.svelte.js",
+        ],
+        languageOptions: {
+            parserOptions: {
+                projectService: true,
+                extraFileExtensions: [".svelte"],
+                parser: tslint.parser,
+                svelteConfig: opts.svelte,
+            },
+        },
+        rules: {
+            "svelte/no-at-html-tags": 0,
+            "svelte/no-navigation-without-resolve": 0,
+            "svelte/prefer-svelte-reactivity": 0,
+        },
+    }
+    : {}, ...rest);

package/dist/eslint.types.d.ts

@@ -0,0 +1,8 @@
+import type { Linter } from "eslint";
+export type InfiniteArray<T> = T | InfiniteArray<T>[];
+export type SimpleExtendsElement = string | Linter.Config;
+export type ExtendsElement = SimpleExtendsElement | InfiniteArray<Linter.Config>;
+export interface ConfigWithExtends extends Linter.Config {
+    extends?: ExtendsElement[];
+}
+export type ConfigWithExtendsArray = InfiniteArray<ConfigWithExtends>[];

package/dist/eslint.types.js

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

package/dist/prettier.d.ts

@@ -1,3 +1,13 @@
 import type { Config, Options } from "prettier";
-export declare const defineConfig: () => Config;
-export declare const pretty: (content: string, parser: Options["parser"]) => Promise<string>;
+/**
+ * @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,9 +1,13 @@
 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";
-export const defineConfig = () => ({
+/**
+ * @param tailwindStylesheet - путь к конфигу Tailwind V4 (`./src/tailwind.css`)
+ */
+export const defineConfig = (tailwindStylesheet) => ({
     tabWidth: 2,
     useTabs: true,
     printWidth: 150,
@@ -24,7 +28,15 @@ export const defineConfig = () => ({
             options: { parser: "svelte" },
         },
     ],
+    tailwindStylesheet,
 });
 //...
-const prettier = defineConfig();
-export const pretty = (content, parser) => format(content, { ...prettier, parser });
+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 });

package/dist/svelte/index.d.ts

@@ -0,0 +1,65 @@
+import type { Adapter, Config } from "@sveltejs/kit";
+export interface SvelteConfigOptions {
+    /**
+     * Адаптер серверной платформы
+     *
+     * @see https://svelte.dev/docs/kit/adapters
+     */
+    adapter: Adapter;
+    /**
+     * Только руны
+     *
+     * @see https://svelte.dev/docs/svelte/what-are-runes
+     *
+     * @default true
+     */
+    runes?: boolean;
+    /**
+     * Проверка источника запроса (CSRF-защита)
+     *
+     * Отключить, если нужна возможность обращения с локалки на прод-приложения
+     *
+     * @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?: Record<string, string>;
+    /**
+     * Переопледеление путей кита
+     */
+    files?: {
+        /**
+         * @default "./static"
+         */
+        assets?: string;
+        /**
+         * @default "./src/app.html"
+         */
+        app_html?: string;
+        /**
+         * @default "./src/error.html"
+         */
+        error_html?: string;
+    };
+    /**
+     * Глобусы исключений из tsconfig-а
+     */
+    exclude?: string[];
+    /**
+     * Глобусы включений из tsconfig-а
+     */
+    include?: string[];
+}
+/**
+ * Конфиг для приложений на `@sveltejs/kit`
+ *
+ * @see https://svelte.dev/docs/kit/introduction
+ */
+export declare const defineConfig: (options: SvelteConfigOptions) => Config;

package/dist/svelte/index.js

@@ -0,0 +1,87 @@
+import { vitePreprocess } from "@sveltejs/vite-plugin-svelte";
+//...
+const isObject = (value) => typeof value === "object" && value !== null;
+const getOptionalObject = (value) => (isObject(value) ? value : {});
+const getOptionalArray = (value) => (Array.isArray(value) ? value : []);
+const setifyArray = (array) => Array.from(new Set(array));
+/**
+ * Конфиг для приложений на `@sveltejs/kit`
+ *
+ * @see https://svelte.dev/docs/kit/introduction
+ */
+export const defineConfig = (options) => ({
+    /**
+     * Настройки поведения svelte-компилятора
+     *
+     * @see https://svelte.dev/docs/svelte/svelte-compiler#CompileOptions
+     */
+    compilerOptions: {
+        runes: options.runes ?? true,
+        /**
+         * Использование современного AST (не знаю, на что влияет)
+         */
+        modernAst: true,
+    },
+    /**
+     * Расширение поддержки всякого в svelte (в т.ч. и полной для typescript)
+     *
+     * @see https://svelte.dev/docs/kit/integrations
+     */
+    preprocess: vitePreprocess({ script: true }),
+    kit: {
+        adapter: options.adapter,
+        csrf: {
+            checkOrigin: options.csrfCheckOrigin,
+        },
+        alias: options.alias,
+        files: {
+            assets: options?.files?.assets,
+            appTemplate: options?.files?.app_html,
+            errorTemplate: options?.files?.error_html,
+        },
+        /**
+         * Переопределение и дополнения к `tsconfig.json`
+         *
+         * @see https://svelte.dev/docs/kit/configuration#typescript
+         */
+        typescript: {
+            config: (config) => {
+                config["compilerOptions"] = {
+                    ...getOptionalObject(config["compilerOptions"]),
+                    allowJs: true,
+                    checkJs: true,
+                    target: "ES2023", // override
+                    module: "NodeNext", // override
+                    moduleResolution: "NodeNext", // override
+                    // noEmit: true,
+                    strict: true,
+                    noImplicitAny: false,
+                    // isolatedModules: true,
+                    esModuleInterop: true,
+                    allowSyntheticDefaultImports: true,
+                    // verbatimModuleSyntax: true,
+                    resolveJsonModule: true,
+                    skipLibCheck: true,
+                    disableSizeLimit: true,
+                    erasableSyntaxOnly: true,
+                };
+                config["exclude"] = setifyArray([
+                    ...getOptionalArray(config["exclude"]),
+                    "../**/trash/**",
+                    "../drafts/**",
+                    ...(options.exclude ?? []),
+                ]);
+                config["include"] = setifyArray([
+                    ...getOptionalArray(config["include"]),
+                    "../scripts/**/*.ts",
+                    "../scripts/**/*.js",
+                    "../types/**/*.ts",
+                    "../*.ts",
+                    "../*.js",
+                    ...(options.include ?? []),
+                ]);
+                return config;
+            },
+        },
+    },
+});

package/dist/svelte/package.d.ts

@@ -1,16 +1,24 @@
 import type { Config } from "@sveltejs/kit";
-export interface SveltePackageOptions {
+export interface SveltePackageConfigOptions {
     /**
+     * Только руны
+     *
+     * @see https://svelte.dev/docs/svelte/what-are-runes
+     *
      * @default true
      */
     runes?: boolean;
     /**
+     * Добавляет алиас `{ "#": "src" }`
+     *
      * @default true
      */
     isolate?: boolean;
     /**
+     * Алиасы путей
+     *
      * @default {}
      */
     alias?: Record<string, string>;
 }
-export declare const definePackageConfig: ({ runes, isolate, alias }?: SveltePackageOptions) => Config;
+export declare const definePackageConfig: ({ runes, isolate, alias }?: SveltePackageConfigOptions) => Config;

package/dist/svelte/package.js

@@ -6,11 +6,6 @@ export const definePackageConfig = ({ runes = true, isolate = true, alias = {} }
      * @see https://svelte.dev/docs/svelte/svelte-compiler#CompileOptions
      */
     compilerOptions: {
-        /**
-         * Только руны
-         *
-         * @see https://svelte.dev/docs/svelte/what-are-runes
-         */
         runes,
         /**
          * Использование современного AST
@@ -23,11 +18,11 @@ export const definePackageConfig = ({ runes = true, isolate = true, alias = {} }
      * @see https://svelte.dev/docs/kit/integrations
      */
     preprocess: vitePreprocess({ script: true }),
-    /**
-     * Алиас корня пакета и его путь
-     */
     kit: {
         files: {
+            /**
+             * Путь к библиотеке
+             */
             lib: "src",
         },
         alias: {

package/dist/vite/index.d.ts

@@ -0,0 +1,50 @@
+import type { BuildOptions, PluginOption, ServerOptions } from "vite";
+import type { ViteUserConfig } from "vitest/config";
+/**
+ * Настройка конфигурации для {@link defineConfig}
+ */
+export interface ViteConfigOptions {
+    /**
+     * Порт приложения
+     *
+     * @see https://vite.dev/config/server-options.html#server-port
+     */
+    port?: ServerOptions["port"];
+    /**
+     * Отключение использования фиксированного порта
+     *
+     * @see https://vite.dev/config/server-options.html#server-strictport
+     */
+    offStrictPort?: boolean;
+    /**
+     * Конфигурация минификации при сборке
+     *
+     * @see https://vite.dev/config/build-options.html#build-minify
+     */
+    minify?: BuildOptions["minify"];
+    /**
+     * Проксирование запросов
+     *
+     * @see https://vite.dev/config/server-options.html#server-proxy
+     */
+    proxy?: ServerOptions["proxy"];
+    /**
+     * Разрешение доступа к общим папкам
+     *
+     * @see https://vite.dev/config/server-options.html#server-fs-allow
+     */
+    allow?: string[];
+    /**
+     * Различные плагины
+     *
+     * @see https://vite.dev/config/shared-options.html#plugins
+     */
+    plugins?: PluginOption[];
+}
+/**
+ * Реструктурированная конфигурация `vite` через `vitest`
+ *
+ * @see https://vite.dev/ Документация Vite
+ * @see https://vitest.dev/ Документация Vitest
+ */
+export declare const defineConfig: (options?: ViteConfigOptions, test?: ViteUserConfig["test"]) => ViteUserConfig;

package/dist/vite/index.js

@@ -0,0 +1,61 @@
+import { defineConfig as defineVitestConfig } from "vitest/config";
+/**
+ * Реструктурированная конфигурация `vite` через `vitest`
+ *
+ * @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,
+    /**
+     * Префикс публичных env-переменных (чтобы совпадало с svelte-kit)
+     *
+     * @see https://vite.dev/config/shared-options.html#envprefix
+     */
+    envPrefix: "PUBLIC_",
+    /**
+     * Конфигурация сервера
+     *
+     * @see https://vite.dev/config/server-options.html
+     */
+    server: {
+        port: options.port,
+        /**
+         * Выдаёт ошибку, если порт занят
+         *
+         * @see https://vite.dev/config/server-options.html#server-strictport
+         */
+        strictPort: !options.offStrictPort,
+        proxy: options.proxy,
+        fs: {
+            allow: options.allow,
+        },
+    },
+    /**
+     * Конфигурация сборки
+     *
+     * @see https://vite.dev/config/build-options.html
+     */
+    build: {
+        minify: options.minify,
+    },
+    plugins: options.plugins,
+    /**
+     * Конфигурация `vitest`
+     *
+     * @see https://vitest.dev/config
+     */
+    test: test ?? {
+        /**
+         * glob-путь к файлам тестов
+         *
+         * @see https://vitest.dev/config/#include
+         */
+        include: ["src/**/*.{test,spec}.{ts,js}"],
+    },
+});

package/dist/vite/proxy.d.ts

@@ -0,0 +1,30 @@
+import type { ServerOptions } from "vite";
+/**
+ * Настройка конфигурации для {@link defineProxyConfig}
+ */
+export interface ViteProxyConfigOptions {
+    /**
+     * URL-адрес сервера, на который будет направляться прокси
+     *
+     * @example `http://localhost:3000`
+     */
+    domain: string;
+    /**
+     * Префикс маршрута, который будет перенаправляться.
+     *
+     * @example `/api/`
+     */
+    prefix: string;
+    /**
+     * Определяет, должен ли изменяться заголовок `Origin` при проксировании
+     *
+     * @default true
+     */
+    changeOrigin?: boolean;
+}
+/**
+ * Создания прокси-конфига для Vite
+ *
+ * Используется для проксирования запросов на основной сервер у приложений
+ */
+export declare const defineProxyConfig: ({ domain: target, prefix, changeOrigin }: ViteProxyConfigOptions) => ServerOptions["proxy"];

package/dist/vite/proxy.js

@@ -0,0 +1,15 @@
+/**
+ * Создания прокси-конфига для Vite
+ *
+ * Используется для проксирования запросов на основной сервер у приложений
+ */
+export const defineProxyConfig = ({ domain: target, prefix, changeOrigin = true }) => {
+    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 } };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nemigo/configs",
-	"version": "0.0.4",
+	"version": "0.2.0",
 	"private": false,
 	"author": {
 		"name": "Vlad Logvin",
@@ -17,14 +17,25 @@
 		"typescript.json"
 	],
 	"exports": {
+		"./.eslint.ignore": {
+			"default": "./.eslint.ignore"
+		},
 		"./eslint": {
 			"types": "./dist/eslint.d.ts",
 			"default": "./dist/eslint.js"
 		},
+		"./eslint/types": {
+			"types": "./dist/eslint/types.d.ts",
+			"default": "./dist/eslint/types.js"
+		},
 		"./prettier": {
 			"types": "./dist/prettier.d.ts",
 			"default": "./dist/prettier.js"
 		},
+		"./svelte": {
+			"types": "./dist/svelte/index.d.ts",
+			"default": "./dist/svelte/index.js"
+		},
 		"./svelte/package": {
 			"types": "./dist/svelte/package.d.ts",
 			"default": "./dist/svelte/package.js"
@@ -32,8 +43,13 @@
 		"./typescript.json": {
 			"default": "./typescript.json"
 		},
-		"./.eslint.ignore": {
-			"default": "./.eslint.ignore"
+		"./vite": {
+			"types": "./dist/vite/index.d.ts",
+			"default": "./dist/vite/index.js"
+		},
+		"./vite/proxy": {
+			"types": "./dist/vite/proxy.d.ts",
+			"default": "./dist/vite/proxy.js"
 		}
 	},
 	"peerDependencies": {