@zilero/eslint 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aleksandr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# 🎯 @zilero/eslint
+
+<p align="center">
+	<a href="https://github.com/Zilero232/dev-config-hub">
+    	<img src="https://img.shields.io/github/actions/workflow/status/Zilero232/dev-config-hub/integrate.yaml?label=CI&logo=GitHub" alt="CI status">
+  	</a>
+	<a href="https://www.npmjs.com/package/@zilero/eslint">
+    	<img src="https://img.shields.io/npm/dm/@zilero/eslint?logo=NPM" alt="npm downloads">
+  	</a>
+	<a href="https://github.com/Zilero232/cli">
+    	<img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="npm license">
+  	</a>
+	<a href="https://github.com/Zilero232/dev-config-hub/tree/main/tools/eslint">
+    	<img src="https://img.shields.io/npm/v/@zilero/eslint?label=version" alt="version">
+  	</a>
+</p>
+
+> ✨ Comprehensive ESLint configuration for React and Node.js projects with TypeScript support
+
+## ✨ Features
+
+- 📦 Ready - made configuration out of the box
+- 🚀 Optimized for React and Node.js
+- 💪 Full TypeScript support
+- 🎨 Integration with Prettier
+- ⚡ High performance
+- 🔧 Easy setup
+- 📱 Next support.JS
+- 🎭 JSX/TSX compatibility
+
+## 📥 Installation
+
+### Using npm
+
+```bash
+npm install --save-dev @zilero/eslint
+```
+### Using yarn
+
+```bash
+yarn add -D @zilero/eslint
+```
+
+### Using pnpm
+
+```bash
+pnpm install -D @zilero/eslint
+```
+
+## 🚀 Quick start
+
+Create the `.eslint.config.js` at the root of your project:
+
+```javascript
+import { eslint } from '@zilero/eslint';
+
+export default eslint({
+  typescript: true
+});
+```
+
+Add scripts to your `package.json`:
+
+```json
+"scripts": {
+  "lint:check": "eslint",
+  "lint:fix": "eslint --fix",
+}
+```
+
+## 🤝 Contributing
+
+We'd love for you to contribute to `@zilero/eslint`! Whether it's reporting bugs, suggesting features, or submitting pull requests, your help is always appreciated.
+
+### How to contribute:
+
+1. Fork the repository.
+2. Create a new branch (`git checkout -b feature/your-feature`).
+3. Make your changes.
+4. Commit your changes (`git commit -am 'Add new feature'`).
+5. Push to the branch (`git push origin feature/your-feature`).
+6. Open a pull request.
+
+## 📜 Code of Conduct
+
+Please follow our [Code of Conduct](CODE_OF_CONDUCT.md) when participating in this project to ensure a welcoming and productive atmosphere.
+
+## 🔒 Security Policy
+
+Security is our priority. If you encounter any issues, please read our full [Security Policy](SECURITY.md) to report vulnerabilities safely and responsibly.
+
+## 👥 Team
+
+These folks keep the project moving and are resources for help.
+
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="11%">
+        <a href="https://career.habr.com/zilero">
+          <img src="https://avatars.githubusercontent.com/u/68345676?s=400&u=eb7df22c29a8aca48def78ec54a7526601c9fd8f&v=4" width="100" height="100" alt="Artemev Alexandr - Avatar">
+          <br />
+          Artemev A. A.
+        </a>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+## 📄 License
+
+License `@zilero/eslint` is licensed under the [MIT License](LICENSE).

package/eslint.config.js

@@ -0,0 +1,462 @@
+import antfu from '@antfu/eslint-config';
+import pluginNext from '@next/eslint-plugin-next';
+import pluginJsxA11y from 'eslint-plugin-jsx-a11y';
+import pluginReact from 'eslint-plugin-react';
+import { transformRules } from './utils/transformRules';
+
+/** @type {import('@zilero/eslint').Eslint} */
+export const eslint = ({ jsxA11y = false, next = false, sort = false, ...options }, ...configs) => {
+	const stylistic = options?.stylistic ?? false;
+
+	if (next) {
+		configs.unshift({
+			name: 'eslint/next',
+			plugins: {
+				'eslint-next': pluginNext,
+			},
+			rules: {
+				...transformRules(pluginNext.configs.recommended.rules, '@next/next', 'eslint-next'),
+			},
+		});
+	}
+
+	if (jsxA11y) {
+		configs.unshift({
+			name: 'eslint/jsx-a11y',
+			plugins: {
+				'eslint-jsx-a11y': pluginJsxA11y,
+			},
+			rules: {
+				...transformRules(pluginJsxA11y.flatConfigs.recommended.rules, 'jsx-a11y', 'eslint-jsx-a11y'),
+			},
+		});
+	}
+
+	if (options.react) {
+		configs.unshift({
+			name: 'eslint/react',
+			plugins: {
+				'eslint-react': pluginReact,
+			},
+			rules: {
+				...transformRules(pluginReact.configs.recommended.rules, 'react', 'eslint-react'),
+
+				/**
+				 * Enforce arrow functions for React components
+				 * @example
+				 * // ✓ Good
+				 * const Component = () => { return <div />; }
+				 * // ✗ Bad
+				 * function Component() { return <div />; }
+				 */
+				'eslint-react/function-component-definition': [
+					'error',
+					{
+						namedComponents: ['arrow-function'], // For named components
+						unnamedComponents: 'arrow-function', // For anonymous components
+					},
+				],
+
+				/**
+				 * Disable PropTypes validation
+				 * Use TypeScript types instead of runtime checks
+				 */
+				'eslint-react/prop-types': 'off',
+
+				/**
+				 * Disable React import requirement
+				 * Not needed in modern React with new JSX transform
+				 * @example
+				 * // ✓ Good
+				 * const App = () => <div />
+				 * // Old way (no longer needed)
+				 * import React from 'react'
+				 */
+				'eslint-react/react-in-jsx-scope': 'off',
+
+				/**
+				 * Enforce destructuring for props and state
+				 * @example
+				 * // ✓ Good
+				 * const { name, age } = props;
+				 * // ✗ Bad
+				 * const name = props.name;
+				 */
+				'eslint-react/destructuring-assignment': ['error', 'always'],
+
+				/**
+				 * Enforce consistent naming for hooks
+				 * @example
+				 * // ✓ Good
+				 * const useCustomHook = () => {};
+				 * // ✗ Bad
+				 * const customHook = () => {};
+				 */
+				'eslint-react/hook-naming-convention': [
+					'error',
+					{
+						prefix: 'use',
+					},
+				],
+
+				/**
+				 * Enforce consistent naming for boolean props
+				 * @example
+				 * // ✓ Good
+				 * <Component isVisible={true} hasData={false} />
+				 * // ✗ Bad
+				 * <Component visible={true} data={false} />
+				 */
+				'eslint-react/boolean-prop-naming': ['error', { prefix: 'is|has|should|can|will|did' }],
+			},
+
+			// React-specific settings
+			settings: {
+				react: {
+					version: 'detect', // Automatically detect React version
+				},
+			},
+		});
+	}
+
+	if (stylistic) {
+		configs.unshift({
+			name: 'eslint/formatter',
+			rules: {
+				/**
+				 * Always require parentheses around arrow function arguments
+				 * @example
+				 * // ✓ Good
+				 * (x) => x
+				 * // ✗ Bad
+				 * x => x
+				 */
+				'style/arrow-parens': ['error', 'always'],
+
+				/**
+				 * Brace style for blocks - disabled to avoid conflicts
+				 * Let other rules handle this
+				 */
+				'style/brace-style': 'off',
+
+				/**
+				 * Disallow trailing commas
+				 * @example
+				 * // ✓ Good
+				 * { a: 1, b: 2 }
+				 * // ✗ Bad
+				 * { a: 1, b: 2, }
+				 */
+				'style/comma-dangle': ['error', 'never'],
+
+				/**
+				 * Enforce 2 spaces indentation with 1 space for switch cases
+				 * @example
+				 * // ✓ Good
+				 * function foo() {
+				 *   if (bar) {
+				 *     baz();
+				 *   }
+				 * }
+				 */
+				'style/indent': ['error', 2, { SwitchCase: 1 }],
+
+				/**
+				 * JSX newline formatting - disabled for better readability
+				 */
+				'style/jsx-curly-newline': 'off',
+
+				/**
+				 * Allow multiple JSX expressions per line
+				 */
+				'style/jsx-one-expression-per-line': 'off',
+
+				/**
+				 * Use single quotes in JSX
+				 * @example
+				 * // ✓ Good
+				 * <div className='foo'>
+				 * // ✗ Bad
+				 * <div className="foo">
+				 */
+				'style/jsx-quotes': ['error', 'prefer-single'],
+
+				/**
+				 * Enforce Unix linebreaks (LF)
+				 * Prevents issues with different operating systems
+				 */
+				'style/linebreak-style': ['error', 'unix'],
+
+				/**
+				 * Maximum line length of 150 characters
+				 * Ignores comments, strings, and template literals
+				 * @example
+				 * // ✓ Good: Lines under 150 characters
+				 * // ✗ Bad: Lines over 150 characters (with exceptions)
+				 */
+				'style/max-len': [
+					'error',
+					150,
+					2,
+					{
+						ignoreComments: true, // Ignore comments when checking length
+						ignoreStrings: true, // Ignore strings when checking length
+						ignoreTemplateLiterals: true, // Ignore template literals when checking length
+					},
+				],
+
+				/**
+				 * TypeScript interface/type member delimiter style - disabled
+				 */
+				'style/member-delimiter-style': 'off',
+
+				/**
+				 * Allow flexible multiline ternary expressions
+				 */
+				'style/multiline-ternary': 'off',
+
+				/**
+				 * Disallow tabs in favor of spaces
+				 */
+				'style/no-tabs': 'error',
+
+				/**
+				 * Allow flexible operator linebreaks
+				 */
+				'style/operator-linebreak': 'off',
+
+				/**
+				 * Quotation marks for object properties - disabled
+				 */
+				'style/quote-props': 'off',
+
+				/**
+				 * Use single quotes for strings, allow template literals
+				 * @example
+				 * // ✓ Good
+				 * const str = 'string'
+				 * const template = `template`
+				 * // ✗ Bad
+				 * const str = "string"
+				 */
+				'style/quotes': ['error', 'single', { allowTemplateLiterals: true }],
+
+				/**
+				 * Require semicolons at the end of statements
+				 * @example
+				 * // ✓ Good
+				 * const foo = 'bar';
+				 * // ✗ Bad
+				 * const foo = 'bar'
+				 */
+				'style/semi': ['error', 'always'],
+			},
+		});
+	}
+
+	if (sort) {
+		configs.unshift({
+			name: 'eslint/sort',
+			rules: {
+				/**
+				 * Sort array includes calls alphabetically
+				 * @example
+				 * // ✓ Good
+				 * ['a', 'b', 'c'].includes(x)
+				 * // ✗ Bad
+				 * ['c', 'a', 'b'].includes(x)
+				 */
+				'perfectionist/sort-array-includes': [
+					'error',
+					{
+						order: 'asc', // Ascending order
+						type: 'alphabetical', // Sort alphabetically
+					},
+				],
+
+				/**
+				 * Enforce consistent import ordering
+				 * Groups:
+				 * 1. Type imports
+				 * 2. Built-in & external modules
+				 * 3. Internal type imports
+				 * 4. Internal modules
+				 * 5. Parent/sibling type imports
+				 * 6. Parent/sibling modules
+				 * 7. Object imports
+				 * 8. Style imports
+				 * 9. Side effect styles
+				 * 10. Unknown
+				 */
+				'perfectionist/sort-imports': [
+					'error',
+					{
+						groups: [
+							'type', // Type imports first
+							['builtin', 'external'], // Node.js and external packages
+							'internal-type', // Internal type imports
+							['internal'], // Internal modules
+							['parent-type', 'sibling-type', 'index-type'], // Relative type imports
+							['parent', 'sibling', 'index'], // Relative module imports
+							'object', // Object imports
+							'style', // Style imports
+							'side-effect-style', // Side effect styles
+							'unknown', // Everything else
+						],
+						internalPattern: ['^~/.*', '^@/.*'], // Internal module patterns
+						newlinesBetween: 'always', // Always add newlines between groups
+						order: 'asc', // Ascending order
+						type: 'natural', // Natural sort order
+					},
+				],
+
+				/**
+				 * Sort interface members
+				 * @example
+				 * // ✓ Good
+				 * interface User {
+				 *   age: number;
+				 *   name: string;
+				 *   sayHello(): void;
+				 * }
+				 */
+				'perfectionist/sort-interfaces': [
+					'error',
+					{
+						groups: ['unknown', 'method', 'multiline'], // Group by type
+						order: 'asc', // Ascending order
+						type: 'alphabetical', // Sort alphabetically
+					},
+				],
+
+				/**
+				 * Sort JSX props in consistent order
+				 * @example
+				 * // ✓ Good
+				 * <Button
+				 *   ref={ref}
+				 *   disabled
+				 *   label="Click me"
+				 *   onClick={handleClick}
+				 * />
+				 */
+				'perfectionist/sort-jsx-props': [
+					'error',
+					{
+						customGroups: {
+							callback: 'on*', // Event handlers
+							reserved: ['key', 'ref'], // React special props
+						},
+						groups: [
+							'shorthand', // Boolean props
+							'reserved', // React special props
+							'multiline', // Multiline props
+							'unknown', // Other props
+							'callback', // Event handlers
+						],
+						order: 'asc', // Ascending order
+						type: 'alphabetical', // Sort alphabetically
+					},
+				],
+
+				/**
+				 * Sort union types consistently
+				 * @example
+				 * // ✓ Good
+				 * type Status = 'error' | 'loading' | 'success';
+				 * type Value = boolean | null | number | string;
+				 */
+				'perfectionist/sort-union-types': [
+					'error',
+					{
+						groups: [
+							'conditional', // Conditional types
+							'function', // Function types
+							'import', // Import types
+							'intersection', // Intersection types
+							'keyword', // TypeScript keywords
+							'literal', // Literal types
+							'named', // Named types
+							'object', // Object types
+							'operator', // Operator types
+							'tuple', // Tuple types
+							'union', // Union types
+							'nullish', // null/undefined
+						],
+						order: 'asc', // Ascending order
+						specialCharacters: 'keep', // Keep special characters
+						type: 'alphabetical', // Sort alphabetically
+					},
+				],
+			},
+		});
+	}
+
+	return antfu(
+		{ ...options, stylistic },
+		{
+			name: 'eslint/rewrite',
+			rules: {
+				/**
+				 * Disable requirement for curly braces
+				 * Allows single-line if statements without braces
+				 * @example
+				 * // Both are allowed:
+				 * if (foo) bar();
+				 * if (foo) { bar(); }
+				 */
+				'antfu/curly': 'off',
+
+				/**
+				 * Disable forced newline after if statement
+				 * Allows more flexible formatting
+				 * @example
+				 * // Both are allowed:
+				 * if (foo) bar();
+				 * if (foo)
+				 *   bar();
+				 */
+				'antfu/if-newline': 'off',
+
+				/**
+				 * Disable top-level function requirements
+				 * Allows both named and anonymous functions at top level
+				 * @example
+				 * // Both are allowed:
+				 * function foo() {}
+				 * export default () => {}
+				 */
+				'antfu/top-level-function': 'off',
+
+				/**
+				 * Warn on console statements
+				 * Helps identify debugging code that shouldn't be in production
+				 * @example
+				 * // ⚠️ Warns:
+				 * console.log('debug');
+				 */
+				'no-console': 'warn',
+
+				/**
+				 * Disable exhaustive dependencies check for React hooks
+				 * Allows manual control over hook dependencies
+				 * @example
+				 * // Allowed:
+				 * useEffect(() => {}, [selectedDeps])
+				 */
+				'react-hooks/exhaustive-deps': 'off',
+
+				/**
+				 * Disable lowercase test title requirement
+				 * Allows more flexible test naming
+				 * @example
+				 * // Both are allowed:
+				 * test('my test')
+				 * test('My Test')
+				 */
+				'test/prefer-lowercase-title': 'off',
+			},
+		},
+		...configs,
+	);
+};

package/index.d.ts

@@ -0,0 +1,32 @@
+import type { Awaitable, ConfigNames, OptionsConfig, TypedFlatConfigItem } from '@antfu/eslint-config';
+import type { Linter } from 'eslint';
+import type { FlatConfigComposer } from 'eslint-flat-config-utils';
+
+/**
+ * Basic configuration options.
+ */
+interface ConfigOptions extends OptionsConfig, TypedFlatConfigItem {
+	/** Enables accessibility rules for JSX */
+	jsxA11y?: boolean;
+	/** Adds support for Next.js */
+	next?: boolean;
+	/** Sorts rules alphabetically */
+	sort?: boolean;
+}
+
+/**
+ * Types of user configurations.
+ */
+type UserConfig = Awaitable<FlatConfigComposer<any, any> | TypedFlatConfigItem | TypedFlatConfigItem[] | Linter.Config[]>;
+
+/**
+ * Main configuration function for ESLint.
+ */
+type ConfigFunction = (options?: ConfigOptions, ...userConfigs: UserConfig[]) => FlatConfigComposer<TypedFlatConfigItem, ConfigNames>;
+
+/**
+ * Exported module.
+ */
+declare module '@zilero/eslint' {
+	export const Eslint: ConfigFunction;
+}

package/index.js

@@ -0,0 +1,3 @@
+const { eslint } = require('./eslint.config.js');
+
+module.exports = { eslint };

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@zilero/eslint",
+  "icon": "🎯",
+  "displayName": "✨ Zilero ESLint Config",
+  "description": "🎯 Comprehensive ESLint configuration for React and Node.js projects",
+  "license": "MIT",
+  "version": "1.0.0",
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "react",
+    "node",
+    "typescript",
+    "javascript",
+    "linting",
+    "prettier",
+    "style-guide",
+    "code-quality"
+  ],
+  "author": {
+    "name": "Artemev Alexandr",
+    "url": "https://github.com/Zilero232",
+    "email": "sasha.artemev.1002@mail.ru"
+  },
+  "bugs": {
+    "url": "https://github.com/Zilero232/dev-config-hub/issues"
+  },
+  "homepage": "https://github.com/Zilero232/dev-config-hub",
+  "repository": {
+    "url": "git+https://github.com/Zilero232/dev-config-hub.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "index.d.ts",
+    "eslint.config.js",
+    "index.js"
+  ],
+  "main": "index.js",
+  "peerDependencies": {
+    "eslint": "^9.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0",
+    "npm": ">=7.0.0"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/Zilero232"
+  },
+  "categories": [
+    "Formatters",
+    "Linters"
+  ],
+  "contributors": [
+    {
+      "name": "Artemev Alexandr",
+      "url": "https://github.com/Zilero232"
+    }
+  ],
+  "dependencies": {
+    "@antfu/eslint-config": "3.12.1",
+    "@eslint-react/eslint-plugin": "1.23.1",
+    "@next/eslint-plugin-next": "15.1.3",
+    "@vue/compiler-sfc": "3.5.13",
+    "eslint": "9.17.0",
+    "eslint-plugin-jsx-a11y": "6.10.2",
+    "eslint-plugin-react": "7.37.3",
+    "eslint-plugin-react-hooks": "5.1.0",
+    "eslint-plugin-react-refresh": "0.4.16"
+  }
+}