dev-configs/docs/requirements.md

dev-configs — Требования

Общее описание

Monorepo библиотека с общими конфигами для TypeScript-проектов. Публикуется как набор npm-пакетов в Gitea npm registry.

Архитектура

• Monorepo: npm workspaces
• Scope: @vigdorov/
• Registry: Gitea npm (https://git.vigdorov.ru/api/packages/vigdorov/npm/)
• Сборка пакетов: tsc → dist/
• Версионирование: Semver, независимое, ручное (npm version -w)
• Публикация: Только пакеты с поднятой версией (CI сравнивает с registry)
• CI: Drone CI, тип library в ci-templates, trigger только на main

Пакеты

@vigdorov/prettier-config

Тип: Статичный объект (без функции-генератора)

{
    "printWidth": 120,
    "tabWidth": 4,
    "useTabs": false,
    "semi": true,
    "singleQuote": true,
    "trailingComma": "all",
    "bracketSpacing": false,
    "jsxSingleQuote": false,
    "arrowParens": "always"
}

@vigdorov/eslint-config

Тип: Функции-генераторы Формат: ESLint 9+ flat config Пресеты: base, react, node

Зависимости:

• eslint
• typescript-eslint (v8+)
• @stylistic/eslint-plugin
• eslint-plugin-unused-imports
• eslint-plugin-react (для react)
• eslint-plugin-react-hooks (для react)

Правила — качество кода (base):

• eqeqeq: "error"
• no-console: ["warn", {allow: ["warn", "error"]}]
• no-alert: "warn"
• no-param-reassign: ["error", {props: true}]
• no-useless-concat: "warn"
• no-else-return: "warn"
• no-lonely-if: "warn"
• no-constructor-return: "warn"
• no-sequences: "warn"
• prefer-promise-reject-errors: "warn"
• require-await: "warn"
• no-new: "warn"
• no-multi-str: "warn"
• no-multi-assign: "warn"
• no-nested-ternary: "warn"
• no-useless-computed-key: "warn"
• no-useless-constructor: "warn"
• no-var: "warn"
• no-duplicate-imports: "warn"
• no-plusplus: "warn"
• no-bitwise: "warn"
• prefer-const: "warn"
• prefer-rest-params: "warn"
• prefer-template: "warn"
• array-callback-return: ["warn", {allowImplicit: true, checkForEach: true}]
• default-param-last: "warn"
• yoda: "warn"

Правила — TypeScript (base):

• @typescript-eslint/no-explicit-any: "error"
• @typescript-eslint/no-empty-object-type: "error"
• @typescript-eslint/no-unsafe-function-type: "error"
• @typescript-eslint/no-wrapper-object-types: "error"
• @typescript-eslint/no-use-before-define: "warn"
• @typescript-eslint/no-shadow: "warn"

Правила — unused imports (base):

• unused-imports/no-unused-imports: "warn"
• unused-imports/no-unused-vars: ["warn", {vars: "all", varsIgnorePattern: "^_", args: "after-used", argsIgnorePattern: "^_"}]

Правила — @stylistic (base):

• @stylistic/no-multiple-empty-lines: ["warn", {max: 1}]
• @stylistic/lines-between-class-members: ["warn", "always"]
• @stylistic/line-comment-position: ["warn", {position: "above"}]
• @stylistic/multiline-comment-style: ["warn", "starred-block"]
• @stylistic/capitalized-comments: "warn"
• @stylistic/max-len: ["warn", {code: 120, ignoreComments: true, ignoreUrls: true, ignoreStrings: true, ignoreTemplateLiterals: true, ignoreRegExpLiterals: true}]

Правила — React (пресет react, поверх base):

• react/prop-types: "off"
• react/react-in-jsx-scope: "off"
• react/jsx-filename-extension: ["warn", {extensions: [".tsx"]}]
• react/jsx-props-no-spreading: "warn"
• react/jsx-key: "warn"
• react/no-array-index-key: "warn"
• react/destructuring-assignment: "warn"
• react/prefer-stateless-function: "warn"
• react/jsx-fragments: ["off", "element"]
• react-hooks/exhaustive-deps: "warn"

Правила — Node (пресет node):

• Базовые правила из base
• React-специфичные правила отключены

@vigdorov/typescript-config

Тип: JSON-файлы для extends (без сборки)

base.json — общие настройки для всех TS-проектов:

• strict: true, target: ES2022, module: ESNext, moduleResolution: bundler

react.json — для React + Vite:

• extends base + DOM libs, jsx: react-jsx, noEmit, allowImportingTsExtensions

node.json — для NestJS/Node:

• extends base + commonjs module, node moduleResolution, decorators support

@vigdorov/vite-config

Тип: Функции-генераторы Пресеты: spa, library

spa — подключает React plugin, алиасы, порт, proxy library — lib mode сборка, external зависимости, форматы es/cjs

Для кастомизации сверх параметров (define, manualChunks) — использовать mergeConfig из vite.

@vigdorov/jest-config

Тип: Функция-генератор

• environment: node/jsdom
• aliases: единый формат с Vite
• transform: @swc/jest

@vigdorov/playwright-config

Тип: Функция-генератор (CI-aware)

• Три браузера: chromium, firefox, webkit
• retries: 0 локально / 2 в CI

@vigdorov/knip-config

Тип: Функция-генератор

• entry, project, ignore, ignoreDependencies
• Exit code 1 при ошибках — блокирует сборку

CI/CD

Тип library в ci-templates

Отдельный library.drone.yml (не base.drone.yml)

Pipeline: prepare → install → test → build → publish

Скрипт publish-lib.sh:

• Настраивает .npmrc с GITEA_TOKEN
• Для каждого пакета в packages/ сравнивает версию с registry
• Публикует только пакеты с новой версией

Trigger: main, push + custom

service.yaml для dev-configs

service:
  name: dev-configs
  type: library

library:
  scope: "@vigdorov"
  registry: "https://git.vigdorov.ru/api/packages/vigdorov/npm/"

Процесс работы с версиями

1. Разработка в feature-ветке
2. Merge в main
3. Поднятие версии: npm version patch -w packages/eslint
4. Commit + push: git commit -am "release: eslint@1.0.1"
5. CI публикует только пакеты с новой версией

Потребители

В каждом проекте-потребителе:

.npmrc:

@vigdorov:registry=https://git.vigdorov.ru/api/packages/vigdorov/npm/

.gitignore (добавить):

coverage/

Структура monorepo

dev-configs/
├── packages/
│   ├── eslint/          → @vigdorov/eslint-config
│   ├── prettier/        → @vigdorov/prettier-config
│   ├── typescript/      → @vigdorov/typescript-config (base, react, node)
│   ├── vite/            → @vigdorov/vite-config
│   ├── jest/            → @vigdorov/jest-config
│   ├── playwright/      → @vigdorov/playwright-config
│   └── knip/            → @vigdorov/knip-config
├── package.json          (workspace root, private: true)
├── tsconfig.base.json    (общий tsconfig для сборки пакетов)
├── .npmrc
├── service.yaml
├── .drone.yml
├── .gitignore
└── CLAUDE.md