eslint-config-mgz 1.0.1

package/README.md

@@ -0,0 +1,288 @@
+# eslint-config-mgz
+
+Shared ESLint configuration for React + TypeScript projects
+
+---
+
+## 🇷🇺 Русский
+
+### 📦 Описание
+
+`eslint-config-mgz` — это переиспользуемая конфигурация ESLint
+для frontend проектов с React и TypeScript:
+
+- ✅ **TypeScript** поддержка с `@typescript-eslint`
+- ✅ **React** правила и хуки
+- ✅ **Import** правила для модулей
+- ✅ **JSX accessibility** проверки
+- ✅ **Prettier** интеграция (отключает конфликтующие правила)
+
+Цель пакета — стандартизировать линтинг во всех проектах и обеспечить качество кода.
+
+---
+
+### 📂 Содержимое пакета
+
+| Файл      | Назначение                     |
+| --------- | ------------------------------ |
+| `base.js` | Основная конфигурация ESLint   |
+
+---
+
+### 🚀 Установка
+
+```bash
+npm install -D eslint-config-mgz eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-import eslint-plugin-jsx-a11y eslint-config-prettier
+```
+
+```bash
+pnpm add -D eslint-config-mgz eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-import eslint-plugin-jsx-a11y eslint-config-prettier
+```
+
+```bash
+yarn add -D eslint-config-mgz eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-import eslint-plugin-jsx-a11y eslint-config-prettier
+```
+
+---
+
+### 🧩 Использование
+
+#### В .eslintrc.js
+
+```javascript
+module.exports = {
+  extends: ["eslint-config-mgz"],
+  parserOptions: {
+    project: "./tsconfig.json",
+  },
+};
+```
+
+#### В .eslintrc.json
+
+```json
+{
+  "extends": ["eslint-config-mgz"],
+  "parserOptions": {
+    "project": "./tsconfig.json"
+  }
+}
+```
+
+#### С дополнительными правилами
+
+```javascript
+module.exports = {
+  extends: ["eslint-config-mgz"],
+  rules: {
+    // Ваши дополнительные правила
+    "no-console": "warn",
+    "@typescript-eslint/no-unused-vars": "error",
+  },
+  parserOptions: {
+    project: "./tsconfig.json",
+  },
+};
+```
+
+---
+
+### 🧠 Включенные правила
+
+#### **ESLint Recommended**
+- Базовые правила JavaScript
+
+#### **TypeScript ESLint**
+- Правила для TypeScript кода
+- Строгая типизация
+- Лучшие практики TS
+
+#### **React ESLint**
+- Правила для React компонентов
+- React Hooks правила
+- JSX правила
+
+#### **Import ESLint**
+- Правила импортов модулей
+- Проверка путей импорта
+
+#### **JSX Accessibility**
+- Доступность JSX элементов
+- WCAG рекомендации
+
+#### **Prettier Integration**
+- Отключение конфликтующих правил
+- Совместимость с prettier
+
+---
+
+### ⚠️ Важные нюансы
+
+- **Peer dependencies**: Все плагины нужно устанавливать отдельно
+- **TypeScript**: Требуется `tsconfig.json` для parserOptions.project
+- **React**: Автоматически определяет версию React
+- **Prettier**: Рекомендуется использовать вместе с prettier-config-mgz
+
+---
+
+### ❓ Возможные вопросы
+
+**Нужен ли tsconfig.json?**
+Да, для правильной работы TypeScript правил нужен файл tsconfig.json.
+
+**Можно ли переопределять правила?**
+Да, добавляйте свои правила в локальном .eslintrc файле.
+
+**Почему некоторые правила отключены?**
+Некоторые правила отключены намеренно для гибкости или из-за конфликтов с другими инструментами.
+
+## 🇬🇧 English
+
+### 📦 Description
+
+`eslint-config-mgz` is a shared ESLint configuration
+for frontend projects with React and TypeScript:
+
+- ✅ **TypeScript** support with `@typescript-eslint`
+- ✅ **React** rules and hooks
+- ✅ **Import** rules for modules
+- ✅ **JSX accessibility** checks
+- ✅ **Prettier** integration (disables conflicting rules)
+
+The goal is to standardize linting across all projects and ensure code quality.
+
+---
+
+### 📂 Package contents
+
+| File      | Purpose                    |
+| --------- | ------------------------- |
+| `base.js` | Main ESLint configuration |
+
+---
+
+### 🚀 Installation
+
+```bash
+npm install -D eslint-config-mgz eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-import eslint-plugin-jsx-a11y eslint-config-prettier
+```
+
+---
+
+### 🧩 Usage
+
+#### In .eslintrc.js
+
+```javascript
+module.exports = {
+  extends: ["eslint-config-mgz"],
+  parserOptions: {
+    project: "./tsconfig.json",
+  },
+};
+```
+
+#### With additional rules
+
+```javascript
+module.exports = {
+  extends: ["eslint-config-mgz"],
+  rules: {
+    // Your additional rules
+    "no-console": "warn",
+  },
+  parserOptions: {
+    project: "./tsconfig.json",
+  },
+};
+```
+
+---
+
+### ⚠️ Important notes
+
+- **Peer dependencies**: All plugins must be installed separately
+- **TypeScript**: Requires `tsconfig.json` for parserOptions.project
+- **React**: Automatically detects React version
+- **Prettier**: Recommended to use with prettier-config-mgz
+
+---
+
+### ❓ Possible questions
+
+**Is tsconfig.json required?**
+Yes, needed for proper TypeScript rules functioning.
+
+**Can rules be overridden?**
+Yes, add your rules in local .eslintrc file.
+
+**Why are some rules disabled?**
+Some rules are intentionally disabled for flexibility or due to conflicts with other tools.
+
+## 🇰🇿 Қазақша
+
+### 📦 Сипаттама
+
+`eslint-config-mgz` — React және TypeScript жобалары үшін
+қайта қолданылатын ESLint конфигурациясы:
+
+- ✅ **TypeScript** `@typescript-eslint` арқылы қолдау
+- ✅ **React** ережелері және хуктары
+- ✅ **Import** модульдердің ережелері
+- ✅ **JSX accessibility** тексерулері
+- ✅ **Prettier** интеграциясы (қайшы келетін ережелерді өшіру)
+
+Мақсаты — барлық жобаларда линтингті стандарттау және код сапасын қамтамасыз ету.
+
+---
+
+### 📂 Пакет құрамында
+
+| Файл      | Мақсаты                  |
+| --------- | ----------------------- |
+| `base.js` | Негізгі ESLint конфигі  |
+
+---
+
+### 🚀 Орнату
+
+```bash
+npm install -D eslint-config-mgz eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin eslint-plugin-react eslint-plugin-react-hooks eslint-plugin-import eslint-plugin-jsx-a11y eslint-config-prettier
+```
+
+---
+
+### 🧩 Қолдану
+
+#### .eslintrc.js ішінде
+
+```javascript
+module.exports = {
+  extends: ["eslint-config-mgz"],
+  parserOptions: {
+    project: "./tsconfig.json",
+  },
+};
+```
+
+---
+
+### ⚠️ Маңызды ескертулер
+
+- **Peer dependencies**: Барлық плагиндерді бөлек орнату қажет
+- **TypeScript**: parserOptions.project үшін tsconfig.json қажет
+- **React**: React нұсқасын автоматты түрде анықтайды
+- **Prettier**: prettier-config-mgz бірге қолдану ұсынылады
+
+---
+
+### ❓ Мүмкін сұрақтар
+
+**tsconfig.json қажет пе?**
+Иә, TypeScript ережелерінің дұрыс жұмысы үшін қажет.
+
+**Ережелерді өзгертуге бола ма?**
+Иә, жергілікті .eslintrc файлында өз ережелеріңізді қосыңыз.
+
+**Неге кейбір ережелер өшірілген?**
+Кейбір ережелер икемділік үшін немесе басқа құралдармен қайшылықтар салдарынан арнайы өшірілген.

package/base.js

@@ -0,0 +1,49 @@
+module.exports = {
+  parser: "@typescript-eslint/parser",
+  extends: [
+    "eslint:recommended",
+    "plugin:react/recommended",
+    "plugin:react-hooks/recommended",
+    "plugin:import/recommended",
+    "plugin:jsx-a11y/recommended",
+    "plugin:@typescript-eslint/recommended",
+    "eslint-config-prettier",
+  ],
+  settings: {
+    react: {
+      version: "detect",
+    },
+    "import/resolver": {
+      node: {
+        paths: ["src"],
+        extensions: [".js", ".jsx", ".ts", ".tsx"],
+      },
+    },
+  },
+  plugins: ["@typescript-eslint"],
+  rules: {
+    "no-alert": "error",
+    "no-console": "error",
+    "no-undef-init": "error",
+    "no-undefined": "error",
+    "no-var": "error",
+    "no-inline-comments": "off",
+    "no-use-before-define": "off",
+    "import/no-unresolved": "off",
+    "react/react-in-jsx-scope": "off",
+    "react/display-name": "off",
+    "react/no-array-index-key": "warn",
+    "no-duplicate-imports": "warn",
+    "jsx-a11y/no-autofocus": "off",
+    "jsx-a11y/anchor-has-content": "off",
+    "jsx-a11y/heading-has-content": "off",
+    "react/prop-types": "off",
+    "react/no-unknown-property": [
+      "error",
+      {
+        ignore: ["cmdk-input-wrapper", "cmdk-empty"],
+      },
+    ],
+    "import/named": "off",
+  },
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "eslint-config-mgz",
+  "version": "1.0.1",
+  "description": "Shared ESLint config for React + TypeScript projects",
+  "main": "base.js",
+  "files": [
+    "README.md",
+    "base.js"
+  ],
+  "readme": "README.md",
+  "keywords": [
+    "eslint",
+    "typescript",
+    "react",
+    "shared-config"
+  ],
+  "author": "DSRC TEAM",
+  "license": "MIT",
+  "peerDependencies": {
+    "eslint": "^8.0.0",
+    "eslint-plugin-react": "^7.0.0",
+    "eslint-plugin-react-hooks": "^4.0.0",
+    "eslint-plugin-import": "^2.0.0",
+    "eslint-plugin-jsx-a11y": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "eslint-config-prettier": "^9.0.0"
+  }
+}