@vortiquo/eslint-config 1.2.3 → 2.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vortiquo/eslint-config",
-  "version": "1.2.3",
+  "version": "2.1.0",
   "description": "Modern ESLint v9 flat configurations with TypeScript, React, Next.js, and Node.js support",
   "type": "module",
   "license": "MIT",
@@ -11,12 +11,13 @@
     "url": "https://github.com/vortiquo/node-eslint-config"
   },
   "scripts": {
-    "lint": "ls-lint",
+    "lint": "eslint --max-warnings 0",
     "format": "prettier --write .",
     "format:check": "prettier --check .",
-    "test": "node scripts/validate-configs.js && node tests/test-configs.js",
-    "test:configs": "node tests/test-configs.js",
-    "prepack": "npm run test",
+    "test:imports": "node ./tests/smoke-imports.mjs",
+    "test:fixtures": "node ./tests/run-eslint-fixtures.mjs",
+    "test": "pnpm run test:imports && pnpm run test:fixtures",
+    "prepack": "pnpm run test",
     "commit": "cz",
     "prepare": "husky"
   },
@@ -41,30 +42,25 @@
     "shared-config"
   ],
   "exports": {
-    ".": "./index.js",
-    "./base": "./base.js",
-    "./base-typescript": "./base-typescript.js",
-    "./react": "./react.js",
-    "./react-library": "./react-library.js",
-    "./react-library-js": "./react-library-js.js",
-    "./nextjs": "./nextjs.js",
-    "./server": "./server.js",
-    "./nestjs": "./nestjs.js",
-    "./node-library": "./node-library.js",
-    "./node-library-js": "./node-library-js.js"
+    ".": "./src/index.js",
+    "./base": "./src/base/index.js",
+    "./ts": "./src/ts/index.js",
+    "./ts/strict": "./src/ts/strict.js",
+    "./server": "./src/server/index.js",
+    "./server/strict": "./src/server/strict.js",
+    "./node-lib": "./src/node-lib/index.js",
+    "./node-lib/strict": "./src/node-lib/strict.js",
+    "./node-lib/js": "./src/node-lib/js.js",
+    "./node-lib/js-strict": "./src/node-lib/js-strict.js",
+    "./react": "./src/react/index.js",
+    "./react/strict": "./src/react/strict.js",
+    "./react-lib": "./src/react-lib/index.js",
+    "./react-lib/strict": "./src/react-lib/strict.js",
+    "./next": "./src/next/index.js",
+    "./next/strict": "./src/next/strict.js"
   },
   "files": [
-    "index.js",
-    "base.js",
-    "base-typescript.js",
-    "react.js",
-    "react-library.js",
-    "react-library-js.js",
-    "nextjs.js",
-    "server.js",
-    "nestjs.js",
-    "node-library.js",
-    "node-library-js.js",
+    "src/**/*.js",
     "README.md",
     "LICENSE"
   ],
@@ -72,9 +68,7 @@
     "@eslint/js": "^9.17.0",
     "@next/eslint-plugin-next": "^16.1.0",
     "eslint-config-prettier": "^10.0.1",
-    "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-only-warn": "^1.1.0",
     "eslint-plugin-react": "^7.37.2",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-simple-import-sort": "^12.1.1",
@@ -87,6 +81,7 @@
     "@commitlint/config-conventional": "^20.2.0",
     "@ls-lint/ls-lint": "^2.3.1",
     "cz-conventional-changelog": "^3.3.0",
+    "eslint": "^9.39.2",
     "husky": "^9.1.7",
     "lint-staged": "^16.2.7",
     "prettier": "^3.7.4"

package/{base.js → src/base/index.js}

@@ -1,7 +1,6 @@
 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';
 
@@ -12,15 +11,27 @@ import turboPlugin from 'eslint-plugin-turbo';
  * @type {import("eslint").Linter.Config[]}
  */
 export const base = [
+  {
+    name: '@vortiquo/base:ignores',
+    ignores: [
+      '**/node_modules/**',
+      '**/dist/**',
+      '**/build/**',
+      '**/.next/**',
+      '**/coverage/**',
+      '**/.turbo/**',
+      '**/public/**',
+    ],
+  },
+
   js.configs.recommended,
-  eslintConfigPrettier,
+
   {
-    name: 'vortiquo/base',
+    name: '@vortiquo/base:plugins',
     plugins: {
       turbo: turboPlugin,
       import: importPlugin,
       'simple-import-sort': simpleImportSort,
-      onlyWarn,
     },
     rules: {
       // Turbo
@@ -58,20 +69,7 @@ export const base = [
     },
   },
   {
-    name: 'vortiquo/base/ignores',
-    ignores: [
-      '**/node_modules/**',
-      '**/dist/**',
-      '**/build/**',
-      '**/.next/**',
-      '**/coverage/**',
-      '**/.turbo/**',
-      '**/public/**',
-    ],
-  },
-  // Relaxations for config files
-  {
-    name: 'vortiquo/base/config-files',
+    name: '@vortiquo/base:config-files',
     files: [
       '**/*.config.{js,ts,mjs,cjs}',
       '**/.*rc.{js,ts,mjs,cjs}',
@@ -79,12 +77,11 @@ export const base = [
       '.lintstagedrc.*',
     ],
     rules: {
-      // Config files require default exports
       'import/no-default-export': 'off',
-      // Allow console in config files
       'no-console': 'off',
     },
   },
+  eslintConfigPrettier,
 ];
 
 export default base;

package/src/index.js

@@ -0,0 +1,25 @@
+export { base } from './base/index.js';
+
+// Next.js
+export { nextjs } from './next/index.js';
+export { nextjsStrict } from './next/strict.js';
+
+// Node.js libraries
+export { nodeLib } from './node-lib/index.js';
+export { nodeLibStrict } from './node-lib/strict.js';
+
+// React
+export { react } from './react/index.js';
+export { reactStrict } from './react/strict.js';
+
+// React libraries
+export { reactLib } from './react-lib/index.js';
+export { reactLibStrict } from './react-lib/strict.js';
+
+// Server (Express, Fastify, etc.)
+export { server } from './server/index.js';
+export { serverStrict } from './server/strict.js';
+
+// TypeScript
+export { baseTs } from './ts/index.js';
+export { tsStrictTypeAware } from './ts/strict.js';

package/src/next/index.js

@@ -0,0 +1,52 @@
+import nextPlugin from '@next/eslint-plugin-next';
+
+import { react } from '../react/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nextjs = [
+  ...react,
+
+  {
+    name: '@vortiquo/nextjs',
+    files: ['**/*.{js,jsx,ts,tsx}'],
+    plugins: {
+      '@next/next': nextPlugin,
+    },
+    rules: {
+      ...nextPlugin.configs.recommended.rules,
+      ...nextPlugin.configs['core-web-vitals'].rules,
+      '@next/next/no-img-element': 'error',
+      '@next/next/no-html-link-for-pages': 'error',
+    },
+  },
+
+  {
+    name: '@vortiquo/nextjs:relax-default-export',
+    files: [
+      // App Router
+      '**/app/**/page.{js,jsx,ts,tsx}',
+      '**/app/**/layout.{js,jsx,ts,tsx}',
+      '**/app/**/loading.{js,jsx,ts,tsx}',
+      '**/app/**/error.{js,jsx,ts,tsx}',
+      '**/app/**/not-found.{js,jsx,ts,tsx}',
+      '**/app/**/route.{js,ts}',
+      '**/app/**/default.{js,jsx,ts,tsx}',
+      '**/app/**/template.{js,jsx,ts,tsx}',
+      '**/app/**/opengraph-image.{js,jsx,ts,tsx}',
+      '**/app/**/twitter-image.{js,jsx,ts,tsx}',
+      '**/app/**/sitemap.{js,ts}',
+      '**/app/**/robots.{js,ts}',
+      // Pages Router
+      '**/pages/**/*.{js,jsx,ts,tsx}',
+      // Middleware
+      '**/middleware.{js,ts}',
+      // Config
+      '**/*.config.{js,ts,mjs,cjs}',
+    ],
+    rules: {
+      'import/no-default-export': 'off',
+    },
+  },
+];
+
+export default nextjs;

package/src/next/strict.js

@@ -0,0 +1,8 @@
+import { reactStrict } from '../react/strict.js';
+import { tsStrictTypeAware } from '../ts/strict.js';
+import { nextjs } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nextjsStrict = [...nextjs, ...reactStrict, ...tsStrictTypeAware];
+
+export default nextjsStrict;

package/src/node-lib/index.js

@@ -0,0 +1,41 @@
+import globals from 'globals';
+
+import { base } from '../base/index.js';
+import { baseTs, TS_FILES } from '../ts/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nodeLib = [
+  ...base,
+  ...baseTs,
+
+  {
+    name: '@vortiquo/node-lib:node-env',
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-console': 'error',
+      'import/no-mutable-exports': 'error',
+    },
+  },
+
+  {
+    name: '@vortiquo/node-lib:scripts',
+    files: ['**/scripts/**/*.{js,cjs,mjs}'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+
+  {
+    name: '@vortiquo/node-lib:ts',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+    },
+  },
+];
+
+export default nodeLib;

package/src/node-lib/js-strict.js

@@ -0,0 +1,44 @@
+import globals from 'globals';
+
+import { base } from '../base/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nodeLibJs = [
+  ...base,
+
+  {
+    name: '@vortiquo/node-lib-js:files',
+    files: ['**/*.{js,cjs,mjs}'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    rules: {
+      // Librería: idealmente sin logs
+      'no-console': 'error',
+    },
+  },
+
+  // Permite console en scripts/ tooling
+  {
+    name: '@vortiquo/node-lib-js:scripts',
+    files: ['**/scripts/**/*.{js,cjs,mjs}'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+
+  // Si la lib usa CJS en algunos archivos
+  {
+    name: '@vortiquo/node-lib-js:cjs',
+    files: ['**/*.cjs'],
+    languageOptions: {
+      sourceType: 'commonjs',
+    },
+  },
+];
+
+export default nodeLibJs;

package/src/node-lib/js.js

@@ -0,0 +1,44 @@
+import globals from 'globals';
+
+import { base } from '../base/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nodeLibJs = [
+  ...base,
+
+  {
+    name: '@vortiquo/node-lib-js:files',
+    files: ['**/*.{js,cjs,mjs}'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+      ecmaVersion: 'latest',
+      sourceType: 'module',
+    },
+    rules: {
+      // Librería: idealmente sin logs
+      'no-console': 'error',
+    },
+  },
+
+  // Permite console en scripts/ tooling
+  {
+    name: '@vortiquo/node-lib-js:scripts',
+    files: ['**/scripts/**/*.{js,cjs,mjs}'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+
+  // Si la lib usa CJS en algunos archivos
+  {
+    name: '@vortiquo/node-lib-js:cjs',
+    files: ['**/*.cjs'],
+    languageOptions: {
+      sourceType: 'commonjs',
+    },
+  },
+];
+
+export default nodeLibJs;

package/src/node-lib/strict.js

@@ -0,0 +1,26 @@
+import { TS_FILES } from '../ts/index.js';
+import { tsStrictTypeAware } from '../ts/strict.js';
+import { nodeLib } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const nodeLibStrict = [
+  ...nodeLib,
+  ...tsStrictTypeAware,
+
+  {
+    name: '@vortiquo/node-lib:strict',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/await-thenable': 'error',
+
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+    },
+  },
+];
+
+export default nodeLibStrict;

package/{react.js → src/react/index.js}

@@ -1,18 +1,17 @@
 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[]}
- */
+import { base } from '../base/index.js';
+import { baseTs } from '../ts/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
 export const react = [
-  ...baseTypescript,
+  ...base,
+  ...baseTs,
+
   {
-    name: 'vortiquo/react',
+    name: '@vortiquo/react',
     files: ['**/*.{jsx,tsx}'],
     plugins: {
       react: reactPlugin,
@@ -23,25 +22,19 @@ export const react = [
         ...globals.browser,
       },
       parserOptions: {
-        ecmaFeatures: {
-          jsx: true,
-        },
+        ecmaFeatures: { jsx: true },
       },
     },
     settings: {
-      react: {
-        version: 'detect',
-      },
+      react: { version: 'detect' },
     },
     rules: {
-      // React recommended
+      // React recommended + JSX runtime (React 17+)
       ...reactPlugin.configs.recommended.rules,
       ...reactPlugin.configs['jsx-runtime'].rules,
 
-      // React Hooks
+      // React Hooks recommended (includes rules-of-hooks + exhaustive-deps)
       ...reactHooksPlugin.configs.recommended.rules,
-
-      // React preferences
       'react/prop-types': 'off',
       'react/jsx-no-target-blank': 'error',
       'react/jsx-curly-brace-presence': [
@@ -51,22 +44,14 @@ export const react = [
       'react/self-closing-comp': 'error',
       'react/jsx-sort-props': [
         'warn',
-        {
-          callbacksLast: true,
-          shorthandFirst: true,
-          reservedFirst: true,
-        },
+        { callbacksLast: true, shorthandFirst: true, reservedFirst: true },
       ],
 
-      // Hooks
-      'react-hooks/rules-of-hooks': 'error',
-      'react-hooks/exhaustive-deps': 'warn',
-
-      // TypeScript handles these
+      // TypeScript handles prop types and defaults better
       'react/require-default-props': 'off',
       'react/jsx-props-no-spreading': 'off',
 
-      // Allow explicit return types to be optional for React components
+      // In React components you typically don't want to enforce return types
       '@typescript-eslint/explicit-function-return-type': 'off',
     },
   },

package/src/react/strict.js

@@ -0,0 +1,15 @@
+import { react } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const reactStrict = [
+  ...react,
+  {
+    name: '@vortiquo/react:strict',
+    files: ['**/*.{jsx,tsx}'],
+    rules: {
+      'react-hooks/exhaustive-deps': 'error',
+    },
+  },
+];
+
+export default reactStrict;

package/src/react-lib/index.js

@@ -0,0 +1,86 @@
+import reactPlugin from 'eslint-plugin-react';
+import reactHooksPlugin from 'eslint-plugin-react-hooks';
+import globals from 'globals';
+
+import { base } from '../base/index.js';
+import { baseTs, TS_FILES } from '../ts/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const reactLib = [
+  ...base,
+  ...baseTs,
+
+  {
+    name: '@vortiquo/react-lib:react',
+    files: ['**/*.{jsx,tsx}'],
+    plugins: {
+      react: reactPlugin,
+      'react-hooks': reactHooksPlugin,
+    },
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+      },
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+    },
+    settings: {
+      react: { version: 'detect' },
+    },
+    rules: {
+      // React core
+      ...reactPlugin.configs.recommended.rules,
+      ...reactPlugin.configs['jsx-runtime'].rules,
+
+      // Hooks
+      ...reactHooksPlugin.configs.recommended.rules,
+
+      // Libraries should not log
+      'no-console': 'error',
+
+      // No prop-types in TS libs
+      'react/prop-types': 'off',
+
+      // Clean JSX
+      'react/self-closing-comp': 'error',
+      'react/jsx-curly-brace-presence': [
+        'error',
+        { props: 'never', children: 'never' },
+      ],
+
+      // Allow spreads (very common in component APIs)
+      'react/jsx-props-no-spreading': 'off',
+
+      // TS handles this better
+      'react/require-default-props': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+    },
+  },
+
+  {
+    name: '@vortiquo/react-lib:style',
+    files: ['src/**/*.{ts,tsx}'],
+    rules: {
+      '@typescript-eslint/consistent-type-definitions': ['error', 'interface'],
+    },
+  },
+
+  // TypeScript-specific expectations for libs
+  {
+    name: '@vortiquo/react-lib:ts',
+    files: TS_FILES,
+    rules: {
+      // Exported APIs should be explicit
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+
+      // Types should be clean and reusable
+      '@typescript-eslint/consistent-type-exports': [
+        'error',
+        { fixMixedExportsWithInlineTypeSpecifier: true },
+      ],
+    },
+  },
+];
+
+export default reactLib;

package/src/react-lib/strict.js

@@ -0,0 +1,30 @@
+import { TS_FILES } from '../ts/index.js';
+import { tsStrictTypeAware } from '../ts/strict.js';
+import { reactLib } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const reactLibStrict = [
+  ...reactLib,
+  ...tsStrictTypeAware,
+
+  {
+    name: '@vortiquo/react-lib:strict',
+    files: TS_FILES,
+    rules: {
+      // Promise safety (important even in UI libs)
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/await-thenable': 'error',
+
+      // Catch subtle API bugs
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+      '@typescript-eslint/switch-exhaustiveness-check': 'error',
+      '@typescript-eslint/no-explicit-any': 'error',
+    },
+  },
+];
+
+export default reactLibStrict;

package/src/server/index.js

@@ -0,0 +1,37 @@
+import globals from 'globals';
+
+import { base } from '../base/index.js';
+import { baseTs, TS_FILES } from '../ts/index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const server = [
+  ...base,
+  ...baseTs,
+
+  {
+    name: '@vortiquo/server:node-env',
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-console': 'off',
+      'no-process-exit': 'off',
+    },
+  },
+
+  {
+    name: '@vortiquo/server:ts-rules',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/explicit-function-return-type': 'error',
+      '@typescript-eslint/explicit-module-boundary-types': 'error',
+
+      '@typescript-eslint/require-await': 'error',
+      '@typescript-eslint/promise-function-async': 'error',
+    },
+  },
+];
+
+export default server;

package/src/server/strict.js

@@ -0,0 +1,24 @@
+import { TS_FILES } from '../ts/index.js';
+import { tsStrictTypeAware } from '../ts/strict.js';
+import { server } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const serverStrict = [
+  ...server,
+  ...tsStrictTypeAware,
+
+  {
+    name: '@vortiquo/server:strict-extras',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/await-thenable': 'error',
+    },
+  },
+];
+
+export default serverStrict;

package/src/ts/index.js

@@ -0,0 +1,68 @@
+import tseslint from 'typescript-eslint';
+
+export const TS_FILES = ['**/*.{ts,tsx,mts,cts}'];
+
+/** @type {import("eslint").Linter.Config[]} */
+export const baseTs = [
+  {
+    name: '@vortiquo/ts:core',
+    files: TS_FILES,
+    languageOptions: {
+      parser: tseslint.parser,
+      parserOptions: {
+        ecmaVersion: 'latest',
+        sourceType: 'module',
+      },
+    },
+    plugins: {
+      '@typescript-eslint': tseslint.plugin,
+    },
+    rules: {
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+        },
+      ],
+
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports', fixStyle: 'separate-type-imports' },
+      ],
+
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/ban-ts-comment': [
+        'error',
+        {
+          'ts-expect-error': 'allow-with-description',
+          minimumDescriptionLength: 5,
+        },
+      ],
+    },
+  },
+
+  {
+    name: '@vortiquo/ts:style',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+    },
+  },
+
+  // Relax rules for config files
+  {
+    name: '@vortiquo/ts:config-files',
+    files: ['**/*.config.{ts,mts,cts}', '**/.*rc.{ts,mts,cts}'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      'no-console': 'off',
+      'import/no-default-export': 'off',
+    },
+  },
+];
+
+export default baseTs;

package/src/ts/strict.js

@@ -0,0 +1,55 @@
+import tseslint from 'typescript-eslint';
+
+import { TS_FILES } from './index.js';
+
+/** @type {import("eslint").Linter.Config[]} */
+export const tsStrictTypeAware = [
+  {
+    name: '@vortiquo/ts:type-aware',
+    files: TS_FILES,
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+      },
+    },
+  },
+
+  ...tseslint.configs.strictTypeChecked.map((cfg) => ({
+    ...cfg,
+    name: cfg.name ? `@vortiquo/ts:strict/${cfg.name}` : '@vortiquo/ts:strict',
+    files: TS_FILES,
+  })),
+
+  ...tseslint.configs.stylisticTypeChecked.map((cfg) => ({
+    ...cfg,
+    name: cfg.name
+      ? `@vortiquo/ts:stylistic/${cfg.name}`
+      : '@vortiquo/ts:stylistic',
+    files: TS_FILES,
+  })),
+
+  {
+    name: '@vortiquo/ts:strict-extras',
+    files: TS_FILES,
+    rules: {
+      '@typescript-eslint/restrict-template-expressions': [
+        'error',
+        {
+          allowNumber: true,
+          allowBoolean: true,
+          allowNullish: false,
+        },
+      ],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        { checksVoidReturn: { attributes: false } },
+      ],
+      '@typescript-eslint/await-thenable': 'error',
+      '@typescript-eslint/switch-exhaustiveness-check': 'error',
+      '@typescript-eslint/no-unnecessary-condition': 'error',
+    },
+  },
+];
+
+export default tsStrictTypeAware;

package/base-typescript.js

@@ -1,167 +0,0 @@
-import tseslint from 'typescript-eslint';
-import { base } from './base.js';
-
-/**
- * TypeScript file patterns - type-aware rules only apply to these
- */
-const TS_FILES = ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'];
-
-/**
- * Base TypeScript ESLint configuration.
- * Extends base config with TypeScript-specific rules.
- *
- * Type-aware rules are ONLY applied to TypeScript files (.ts, .tsx, .mts, .cts).
- * JavaScript files (including config files like eslint.config.js) are not affected.
- *
- * @type {import("eslint").Linter.Config[]}
- */
-export const baseTypescript = [
-  ...base,
-
-  // Global TypeScript plugin registration (plugins must be defined globally)
-  {
-    name: 'vortiquo/typescript-plugins',
-    plugins: {
-      '@typescript-eslint': tseslint.plugin,
-    },
-  },
-
-  // Allow relative imports in config files (only applies to TS files since
-  // no-restricted-imports is only defined in base-typescript)
-  {
-    name: 'vortiquo/typescript/config-files',
-    files: ['**/*.config.ts', '**/*.config.mts', '**/*.config.cts'],
-    languageOptions: {
-      parser: tseslint.parser,
-      parserOptions: {
-        projectService: false, // Config files don't need full project analysis
-      },
-    },
-    rules: {
-      // Inherit base config file rules
-      'import/no-default-export': 'off',
-      'no-console': 'off',
-      // TypeScript-specific overrides
-      'no-restricted-imports': 'off',
-      '@typescript-eslint/no-unsafe-assignment': 'off',
-    },
-  },
-
-  // TypeScript parser and language options (scoped to TS files, excluding config files)
-  {
-    name: 'vortiquo/typescript-parser',
-    files: TS_FILES,
-    ignores: ['**/*.config.ts', '**/*.config.mts', '**/*.config.cts'],
-    languageOptions: {
-      parser: tseslint.parser,
-      parserOptions: {
-        projectService: true,
-      },
-    },
-  },
-
-  // Apply type-checked rules ONLY to TypeScript files
-  // Apply strict type-checked rules to TS files
-  ...tseslint.configs.strictTypeChecked.map((config) => ({
-    ...config,
-    files: TS_FILES,
-  })),
-  // Apply stylistic type-checked rules to TS files
-  ...tseslint.configs.stylisticTypeChecked.map((config) => ({
-    ...config,
-    files: TS_FILES,
-  })),
-
-  // TypeScript-specific settings and rules (only for TS files)
-  {
-    name: 'vortiquo/typescript',
-    files: TS_FILES,
-    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',
-
-      // Enforce absolute imports (use tsconfig paths instead of relative)
-      'no-restricted-imports': [
-        'error',
-        {
-          patterns: [
-            {
-              group: ['src/**/*', '../**/*'],
-              message:
-                'Usage of src/* and ../**/* imports is not allowed, use paths defined in tsconfig',
-            },
-          ],
-        },
-      ],
-    },
-  },
-];
-
-export default baseTypescript;

package/index.js

@@ -1,11 +0,0 @@
-// 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 { reactLibraryJs } from './react-library-js.js';
-export { nextjs } from './nextjs.js';
-export { server } from './server.js';
-export { nestjs } from './nestjs.js';
-export { nodeLibrary } from './node-library.js';
-export { nodeLibraryJs } from './node-library-js.js';

package/nestjs.js

@@ -1,43 +0,0 @@
-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

@@ -1,51 +0,0 @@
-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.js

@@ -1,26 +0,0 @@
-import globals from 'globals';
-import { base } from './base.js';
-
-/**
- * ESLint configuration for JavaScript Node.js libraries/packages.
- * For projects without TypeScript - extends base config only.
- *
- * @type {import("eslint").Linter.Config[]}
- */
-export const nodeLibraryJs = [
-  ...base,
-  {
-    name: 'vortiquo/node-library-js',
-    languageOptions: {
-      globals: {
-        ...globals.node,
-      },
-    },
-    rules: {
-      // No console in libraries (consumers should handle logging)
-      'no-console': 'error',
-    },
-  },
-];
-
-export default nodeLibraryJs;

package/node-library.js

@@ -1,44 +0,0 @@
-import globals from 'globals';
-import { baseTypescript } from './base-typescript.js';
-
-/**
- * TypeScript file patterns - type-aware rules only apply to these
- */
-const TS_FILES = ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'];
-
-/**
- * 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: {
-      // No console in libraries (consumers should handle logging)
-      'no-console': 'error',
-    },
-  },
-  {
-    name: 'vortiquo/node-library/typescript',
-    files: TS_FILES,
-    rules: {
-      // Libraries should be strict
-      '@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',
-    },
-  },
-];
-
-export default nodeLibrary;

package/react-library-js.js

@@ -1,72 +0,0 @@
-import reactPlugin from 'eslint-plugin-react';
-import reactHooksPlugin from 'eslint-plugin-react-hooks';
-import globals from 'globals';
-import { base } from './base.js';
-
-/**
- * ESLint configuration for JavaScript React libraries/components.
- * For projects without TypeScript - extends base config only.
- *
- * @type {import("eslint").Linter.Config[]}
- */
-export const reactLibraryJs = [
-  ...base,
-  {
-    name: 'vortiquo/react-library-js',
-    files: ['**/*.{js,jsx,mjs,cjs}'],
-    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',
-
-      // Not needed without TypeScript
-      'react/require-default-props': 'off',
-      'react/jsx-props-no-spreading': 'off',
-    },
-  },
-];
-
-export default reactLibraryJs;

package/react-library.js

@@ -1,36 +0,0 @@
-import { react } from './react.js';
-
-/**
- * TypeScript file patterns - type-aware rules only apply to these
- */
-const TS_FILES = ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'];
-
-/**
- * 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: {
-      // No console in libraries
-      'no-console': 'error',
-
-      // Prefer named exports for tree-shaking
-      'import/no-default-export': 'error',
-    },
-  },
-  {
-    name: 'vortiquo/react-library/typescript',
-    files: TS_FILES,
-    rules: {
-      // Libraries should be stricter about exports
-      '@typescript-eslint/explicit-module-boundary-types': 'error',
-    },
-  },
-];
-
-export default reactLibrary;

package/server.js

@@ -1,49 +0,0 @@
-import globals from 'globals';
-import { baseTypescript } from './base-typescript.js';
-
-/**
- * TypeScript file patterns - type-aware rules only apply to these
- */
-const TS_FILES = ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'];
-
-/**
- * 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',
-    },
-  },
-  {
-    name: 'vortiquo/server/typescript',
-    files: TS_FILES,
-    rules: {
-      // 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',
-    },
-  },
-];
-
-export default server;