@vortiquo/eslint-config 0.0.1

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Vortiquo
+
+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,192 @@
+# @vortiquo/eslint-config
+
+[![npm version](https://img.shields.io/npm/v/@vortiquo/eslint-config.svg)](https://www.npmjs.com/package/@vortiquo/eslint-config)
+[![license](https://img.shields.io/npm/l/@vortiquo/eslint-config.svg)](https://github.com/vortiquo/configs/blob/main/LICENSE)
+
+Modern ESLint v9 flat configurations with TypeScript, React, and Node.js
+support.
+
+## Features
+
+- ⚡ **ESLint v9** - Modern flat config format
+- 🔒 **Strict TypeScript** - Uses `strictTypeChecked` preset
+- 📦 **Ready-to-use presets** - Next.js, React, Node.js, NestJS
+- 🎨 **Prettier compatible** - No formatting conflicts
+- 📝 **Import sorting** - Auto-fixable with `simple-import-sort`
+- 🏎️ **Turbo support** - Monorepo cache awareness
+
+## Installation
+
+```bash
+npm install -D @vortiquo/eslint-config eslint typescript
+# or
+pnpm add -D @vortiquo/eslint-config eslint typescript
+# or
+yarn add -D @vortiquo/eslint-config eslint typescript
+```
+
+## Available Configs
+
+| Config          | Use Case                              |
+| --------------- | ------------------------------------- |
+| `nextjs`        | Next.js applications                  |
+| `server`        | Backend APIs (Fastify, Express, Hono) |
+| `nestjs`        | NestJS applications                   |
+| `react`         | React applications                    |
+| `react-library` | React/UI component libraries          |
+| `node-library`  | Shared Node.js packages               |
+
+## Usage
+
+Create an `eslint.config.js` in your project:
+
+### Next.js
+
+```js
+import { nextjs } from '@vortiquo/eslint-config/nextjs';
+
+export default [
+  ...nextjs,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+  },
+];
+```
+
+### Backend API (Fastify/Express/Hono)
+
+```js
+import { server } from '@vortiquo/eslint-config/server';
+
+export default [
+  ...server,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+  },
+];
+```
+
+### NestJS
+
+```js
+import { nestjs } from '@vortiquo/eslint-config/nestjs';
+
+export default [
+  ...nestjs,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+  },
+];
+```
+
+### React Component Library
+
+```js
+import { reactLibrary } from '@vortiquo/eslint-config/react-library';
+
+export default [
+  ...reactLibrary,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+  },
+];
+```
+
+### Node.js Library
+
+```js
+import { nodeLibrary } from '@vortiquo/eslint-config/node-library';
+
+export default [
+  ...nodeLibrary,
+  {
+    languageOptions: {
+      parserOptions: {
+        project: './tsconfig.json',
+      },
+    },
+  },
+];
+```
+
+## Extending Configs
+
+All configs are arrays that can be spread and extended:
+
+```js
+import { nextjs } from '@vortiquo/eslint-config/nextjs';
+
+export default [
+  ...nextjs,
+  {
+    rules: {
+      'no-console': 'off',
+    },
+  },
+  {
+    ignores: ['generated/**'],
+  },
+];
+```
+
+## What's Included
+
+### Base Rules
+
+- Prettier integration (formatting handled by Prettier)
+- Turbo plugin (monorepo cache awareness)
+- Import sorting (auto-fixable)
+- Best practices (curly, eqeqeq, prefer-const)
+
+### TypeScript Rules
+
+- Strict type checking (`strictTypeChecked`)
+- Consistent type imports/exports
+- No explicit `any`
+- Promise handling (`no-floating-promises`)
+
+### React Rules
+
+- React recommended + JSX runtime
+- React Hooks rules
+- Self-closing components
+- Prop sorting
+
+### Next.js Rules
+
+- Core Web Vitals
+- Image optimization
+- App Router support
+
+## Config Hierarchy
+
+```
+base (JS rules, Prettier, Turbo)
+└── base-typescript (TS strict rules)
+    ├── react (React + Hooks)
+    │   ├── react-library (stricter)
+    │   └── nextjs (Next.js specific)
+    ├── server (Node.js APIs)
+    │   └── nestjs (decorators)
+    └── node-library (Node.js packages)
+```
+
+## License
+
+MIT © [Vortiquo](https://vortiquo.com)

package/base-typescript.js

@@ -0,0 +1,90 @@
+import tseslint from 'typescript-eslint';
+import { base } from './base.js';
+
+/**
+ * Base TypeScript ESLint configuration.
+ * Extends base config with TypeScript-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const baseTypescript = [
+  ...base,
+  ...tseslint.configs.strictTypeChecked,
+  ...tseslint.configs.stylisticTypeChecked,
+  {
+    name: 'vortiquo/typescript',
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+      },
+    },
+    settings: {
+      'import/resolver': {
+        typescript: true,
+        node: true,
+      },
+    },
+    rules: {
+      // Override base no-unused-vars with TypeScript version
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+
+      // Type imports (enforces `import type` for types - better tree-shaking)
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports', fixStyle: 'separate-type-imports' },
+      ],
+      '@typescript-eslint/consistent-type-exports': [
+        'error',
+        { fixMixedExportsWithInlineTypeSpecifier: true },
+      ],
+
+      // Strictness - catch bugs early
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-use-before-define': [
+        'error',
+        { functions: false, classes: true, variables: true },
+      ],
+      '@typescript-eslint/explicit-function-return-type': [
+        'error',
+        {
+          allowExpressions: true,
+          allowTypedFunctionExpressions: true,
+          allowHigherOrderFunctions: true,
+        },
+      ],
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/await-thenable': 'error',
+
+      // Preferences
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+      '@typescript-eslint/array-type': ['error', { default: 'array-simple' }],
+      '@typescript-eslint/prefer-nullish-coalescing': 'error',
+      '@typescript-eslint/prefer-optional-chain': 'error',
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+      '@typescript-eslint/switch-exhaustiveness-check': 'error',
+
+      // Relaxations (good DX without sacrificing safety)
+      '@typescript-eslint/no-confusing-void-expression': 'off',
+      '@typescript-eslint/restrict-template-expressions': [
+        'error',
+        { allowNumber: true, allowBoolean: true },
+      ],
+      // This one is too strict - TS already handles this well
+      '@typescript-eslint/require-await': 'off',
+    },
+  },
+];
+
+export default baseTypescript;

package/base.js

@@ -0,0 +1,74 @@
+import js from '@eslint/js';
+import eslintConfigPrettier from 'eslint-config-prettier';
+import importPlugin from 'eslint-plugin-import';
+import onlyWarn from 'eslint-plugin-only-warn';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import turboPlugin from 'eslint-plugin-turbo';
+
+/**
+ * Base ESLint configuration for all projects.
+ * This config provides JavaScript rules and general best practices.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const base = [
+  js.configs.recommended,
+  eslintConfigPrettier,
+  {
+    name: 'vortiquo/base',
+    plugins: {
+      turbo: turboPlugin,
+      import: importPlugin,
+      'simple-import-sort': simpleImportSort,
+      onlyWarn,
+    },
+    rules: {
+      // Turbo
+      'turbo/no-undeclared-env-vars': 'warn',
+
+      // Best practices
+      curly: 'error',
+      eqeqeq: ['error', 'always', { null: 'ignore' }],
+      'no-console': ['warn', { allow: ['warn', 'error'] }],
+      'no-debugger': 'warn',
+      'no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+
+      // Style
+      'prefer-const': 'error',
+      'prefer-template': 'error',
+      'object-shorthand': 'error',
+      'no-var': 'error',
+
+      // Import sorting (auto-fixable, great DX)
+      'simple-import-sort/imports': 'error',
+      'simple-import-sort/exports': 'error',
+
+      // Import rules
+      'import/first': 'error',
+      'import/newline-after-import': 'error',
+      'import/no-duplicates': 'error',
+      'import/no-mutable-exports': 'error',
+    },
+  },
+  {
+    name: 'vortiquo/base/ignores',
+    ignores: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/build/**',
+      '**/.next/**',
+      '**/coverage/**',
+      '**/.turbo/**',
+      '**/public/**',
+    ],
+  },
+];
+
+export default base;

package/index.js

@@ -0,0 +1,9 @@
+// Re-export all configs for convenience
+export { base } from './base.js';
+export { baseTypescript } from './base-typescript.js';
+export { react } from './react.js';
+export { reactLibrary } from './react-library.js';
+export { nextjs } from './nextjs.js';
+export { server } from './server.js';
+export { nestjs } from './nestjs.js';
+export { nodeLibrary } from './node-library.js';

package/nestjs.js

@@ -0,0 +1,43 @@
+import { server } from './server.js';
+
+/**
+ * ESLint configuration for NestJS applications.
+ * Extends server config with NestJS-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const nestjs = [
+  ...server,
+  {
+    name: 'vortiquo/nestjs',
+    rules: {
+      // NestJS uses classes extensively
+      '@typescript-eslint/consistent-type-definitions': 'off',
+
+      // NestJS uses empty constructors for DI
+      '@typescript-eslint/no-empty-function': [
+        'error',
+        { allow: ['constructors'] },
+      ],
+
+      // NestJS decorators often require classes
+      '@typescript-eslint/no-extraneous-class': 'off',
+
+      // NestJS uses parameter properties
+      '@typescript-eslint/parameter-properties': 'off',
+
+      // Allow unused vars in decorators (common pattern)
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+          args: 'after-used',
+        },
+      ],
+    },
+  },
+];
+
+export default nestjs;

package/nextjs.js

@@ -0,0 +1,51 @@
+import nextPlugin from '@next/eslint-plugin-next';
+import { react } from './react.js';
+
+/**
+ * ESLint configuration for Next.js applications.
+ * Extends React config with Next.js-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const nextjs = [
+  ...react,
+  {
+    name: 'vortiquo/nextjs',
+    plugins: {
+      '@next/next': nextPlugin,
+    },
+    rules: {
+      ...nextPlugin.configs.recommended.rules,
+      ...nextPlugin.configs['core-web-vitals'].rules,
+
+      // Next.js specific
+      '@next/next/no-html-link-for-pages': 'error',
+      '@next/next/no-img-element': 'error',
+    },
+  },
+  {
+    name: 'vortiquo/nextjs/relaxations',
+    files: [
+      '**/app/**/page.tsx',
+      '**/app/**/layout.tsx',
+      '**/app/**/loading.tsx',
+      '**/app/**/error.tsx',
+      '**/app/**/not-found.tsx',
+      '**/app/**/route.ts',
+      '**/app/**/default.tsx',
+      '**/app/**/template.tsx',
+      '**/app/**/opengraph-image.tsx',
+      '**/app/**/twitter-image.tsx',
+      '**/app/**/sitemap.ts',
+      '**/app/**/robots.ts',
+      '**/middleware.ts',
+      '**/*.config.{js,ts,mjs}',
+    ],
+    rules: {
+      // Next.js requires default exports for these files
+      'import/no-default-export': 'off',
+    },
+  },
+];
+
+export default nextjs;

package/node-library.js

@@ -0,0 +1,42 @@
+import globals from 'globals';
+import { baseTypescript } from './base-typescript.js';
+
+/**
+ * ESLint configuration for Node.js libraries/packages.
+ * Extends TypeScript config for shared backend packages.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const nodeLibrary = [
+  ...baseTypescript,
+  {
+    name: 'vortiquo/node-library',
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      // Libraries should be strict
+      '@typescript-eslint/explicit-function-return-type': 'error',
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+
+      // No console in libraries (consumers should handle logging)
+      'no-console': 'error',
+
+      // Async handling
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/require-await': 'error',
+    },
+  },
+  {
+    name: 'vortiquo/node-library/config-files',
+    files: ['**/*.config.{js,ts,mjs}', '**/tsup.config.ts'],
+    rules: {
+      'import/no-default-export': 'off',
+      'no-console': 'off',
+    },
+  },
+];
+
+export default nodeLibrary;

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@vortiquo/eslint-config",
+  "version": "0.0.1",
+  "description": "Modern ESLint v9 flat configurations with TypeScript, React, Next.js, and Node.js support",
+  "type": "module",
+  "license": "MIT",
+  "author": "Vortiquo <dev@vortiquo.com>",
+  "homepage": "https://github.com/vortiquo/eslint-config#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vortiquo/eslint-config"
+  },
+  "scripts": {
+    "lint": "ls-lint",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "commit": "cz",
+    "prepare": "husky"
+  },
+  "bugs": {
+    "url": "https://github.com/vortiquo/eslint-config/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "eslint-flat-config",
+    "eslint9",
+    "typescript",
+    "react",
+    "nextjs",
+    "nestjs",
+    "nodejs",
+    "prettier",
+    "strict",
+    "shared-config"
+  ],
+  "exports": {
+    ".": "./index.js",
+    "./base": "./base.js",
+    "./base-typescript": "./base-typescript.js",
+    "./react": "./react.js",
+    "./react-library": "./react-library.js",
+    "./nextjs": "./nextjs.js",
+    "./server": "./server.js",
+    "./nestjs": "./nestjs.js",
+    "./node-library": "./node-library.js"
+  },
+  "files": [
+    "index.js",
+    "base.js",
+    "base-typescript.js",
+    "react.js",
+    "react-library.js",
+    "nextjs.js",
+    "server.js",
+    "nestjs.js",
+    "node-library.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@commitlint/cli": "^20.2.0",
+    "@commitlint/config-conventional": "^20.2.0",
+    "@eslint/js": "^9.17.0",
+    "@ls-lint/ls-lint": "^2.3.1",
+    "@next/eslint-plugin-next": "^15.1.0",
+    "cz-conventional-changelog": "^3.3.0",
+    "eslint-config-prettier": "^10.0.1",
+    "eslint-import-resolver-typescript": "^3.7.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-only-warn": "^1.1.0",
+    "eslint-plugin-react": "^7.37.2",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-turbo": "^2.3.3",
+    "globals": "^15.14.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "typescript-eslint": "^8.18.1"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0",
+    "typescript": "^5.0.0"
+  }
+}

package/react-library.js

@@ -0,0 +1,34 @@
+import { react } from './react.js';
+
+/**
+ * ESLint configuration for React component libraries.
+ * Extends React config with library-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const reactLibrary = [
+  ...react,
+  {
+    name: 'vortiquo/react-library',
+    rules: {
+      // Libraries should be stricter about exports
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+
+      // No console in libraries
+      'no-console': 'error',
+
+      // Prefer named exports for tree-shaking
+      'import/no-default-export': 'error',
+    },
+  },
+  {
+    name: 'vortiquo/react-library/config-files',
+    files: ['**/*.config.{js,ts,mjs}', '**/tsup.config.ts'],
+    rules: {
+      'import/no-default-export': 'off',
+      'no-console': 'off',
+    },
+  },
+];
+
+export default reactLibrary;

package/react.js

@@ -0,0 +1,75 @@
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import globals from 'globals';
+import { baseTypescript } from './base-typescript.js';
+
+/**
+ * ESLint configuration for React projects (libraries, components).
+ * Extends TypeScript config with React-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const react = [
+  ...baseTypescript,
+  {
+    name: 'vortiquo/react',
+    files: ['**/*.{jsx,tsx}'],
+    plugins: {
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+    },
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+      },
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+    },
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+    rules: {
+      // React recommended
+      ...reactPlugin.configs.recommended.rules,
+      ...reactPlugin.configs['jsx-runtime'].rules,
+
+      // React Hooks
+      ...reactHooksPlugin.configs.recommended.rules,
+
+      // React preferences
+      'react/prop-types': 'off',
+      'react/jsx-no-target-blank': 'error',
+      'react/jsx-curly-brace-presence': [
+        'error',
+        { props: 'never', children: 'never' },
+      ],
+      'react/self-closing-comp': 'error',
+      'react/jsx-sort-props': [
+        'warn',
+        {
+          callbacksLast: true,
+          shorthandFirst: true,
+          reservedFirst: true,
+        },
+      ],
+
+      // Hooks
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'warn',
+
+      // TypeScript handles these
+      'react/require-default-props': 'off',
+      'react/jsx-props-no-spreading': 'off',
+
+      // Allow explicit return types to be optional for React components
+      '@typescript-eslint/explicit-function-return-type': 'off',
+    },
+  },
+];
+
+export default react;

package/server.js

@@ -0,0 +1,47 @@
+import globals from 'globals';
+import { baseTypescript } from './base-typescript.js';
+
+/**
+ * ESLint configuration for backend APIs (Fastify, Express, Hono).
+ * Extends TypeScript config with Node.js-specific rules.
+ *
+ * @type {import("eslint").Linter.Config[]}
+ */
+export const server = [
+  ...baseTypescript,
+  {
+    name: 'vortiquo/server',
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      // Allow console in backend
+      'no-console': 'off',
+
+      // Backend-specific rules
+      'no-process-exit': 'off',
+
+      // Stricter for backend code
+      '@typescript-eslint/explicit-function-return-type': 'error',
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+
+      // Async handling
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/require-await': 'error',
+      '@typescript-eslint/await-thenable': 'error',
+      '@typescript-eslint/promise-function-async': 'error',
+    },
+  },
+  {
+    name: 'vortiquo/server/config-files',
+    files: ['**/*.config.{js,ts,mjs}'],
+    rules: {
+      // Config files often use default exports
+      'import/no-default-export': 'off',
+    },
+  },
+];
+
+export default server;