# 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

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

```json
{
    "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

```yaml
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:**
```ini
@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
```