@higuma/eslint-config 0.1.0

package/README.md

@@ -0,0 +1,87 @@
+# @higuma/eslint-config
+
+Shared ESLint flat configs (ESLint 9+) for Higuma Soft projects.
+
+## Installation
+
+```bash
+# All projects need these
+npm install --save-dev @higuma/eslint-config eslint typescript-eslint @eslint/js globals \
+  eslint-plugin-simple-import-sort eslint-plugin-unused-imports
+
+# React / Next.js projects also need
+npm install --save-dev eslint-plugin-react eslint-plugin-react-hooks
+
+# Next.js projects also need
+npm install --save-dev @next/eslint-plugin-next
+```
+
+## Configs
+
+| Import | Use for |
+|--------|---------|
+| `@higuma/eslint-config/base` | Any TS project — libraries, Node, CLI |
+| `@higuma/eslint-config/react` | React SPA |
+| `@higuma/eslint-config/next` | Next.js app |
+
+## Usage
+
+### Library (registrie)
+
+```js
+// eslint.config.mjs
+import base from '@higuma/eslint-config/base';
+export default base;
+```
+
+### React SPA
+
+```js
+// eslint.config.mjs
+import react from '@higuma/eslint-config/react';
+export default react;
+```
+
+### Next.js
+
+```js
+// eslint.config.mjs
+import next from '@higuma/eslint-config/next';
+export default next;
+```
+
+### With overrides
+
+```js
+// eslint.config.mjs
+import base from '@higuma/eslint-config/base';
+
+export default [
+  ...base,
+  {
+    rules: {
+      'no-console': 'warn', // downgrade for this project
+    },
+  },
+];
+```
+
+## Rules included in all configs
+
+| Rule | Level |
+|------|-------|
+| `simple-import-sort/imports` | error |
+| `unused-imports/no-unused-imports` | error |
+| `@typescript-eslint/no-explicit-any` | error |
+| `@typescript-eslint/no-unused-vars` | error |
+| `@typescript-eslint/no-non-null-assertion` | warn |
+| `@typescript-eslint/consistent-type-imports` | error |
+| `@typescript-eslint/no-floating-promises` | error |
+| `no-console` | error |
+| `no-var` | error |
+| `prefer-const` | error |
+| `eqeqeq` | error |
+| `consistent-return` | error |
+| `no-shadow` | error |
+
+Test files (`*.test.ts`, `*.spec.ts`, `test/**`) get `no-explicit-any`, `no-non-null-assertion`, `no-floating-promises`, and `no-console` turned off.

package/base.js

@@ -0,0 +1,80 @@
+// @higuma/eslint-config/base
+// Strict TypeScript flat config for any project (library, Node, browser).
+// Consumers: registrie and any non-React project.
+
+import js from '@eslint/js';
+import globals from 'globals';
+import tseslint from 'typescript-eslint';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
+import unusedImports from 'eslint-plugin-unused-imports';
+
+/** @type {import('eslint').Linter.Config[]} */
+const base = tseslint.config(
+  // Global ignores
+  {
+    ignores: ['dist/**', 'node_modules/**', '.next/**', 'coverage/**'],
+  },
+
+  // ESLint + TS recommended baseline
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+
+  // Main rules
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    languageOptions: {
+      globals: {
+        ...globals.node,
+      },
+    },
+    plugins: {
+      'simple-import-sort': simpleImportSort,
+      'unused-imports': unusedImports,
+    },
+    rules: {
+      // — Imports —
+      'simple-import-sort/imports': 'error',
+      'simple-import-sort/exports': 'error',
+      'unused-imports/no-unused-imports': 'error',
+
+      // — TypeScript —
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
+      ],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/consistent-type-definitions': ['error', 'type'],
+
+      // — General —
+      'no-console': 'error',
+      'no-var': 'error',
+      'prefer-const': 'error',
+      eqeqeq: ['error', 'always'],
+      'consistent-return': 'error',
+      'no-shadow': 'error',
+    },
+  },
+
+  // Test files — relaxed
+  {
+    files: ['**/*.test.ts', '**/*.spec.ts', 'test/**/*.ts', '**/*.test.tsx'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      '@typescript-eslint/no-non-null-assertion': 'off',
+      '@typescript-eslint/no-floating-promises': 'off',
+      'no-console': 'off',
+    },
+  }
+);
+
+export default base;

package/index.js

@@ -0,0 +1,7 @@
+// @higuma/eslint-config
+// Re-exports all configs for convenience.
+// Prefer named imports: import base from '@higuma/eslint-config/base'
+
+export { default as base } from './base.js';
+export { default as react } from './react.js';
+export { default as next } from './next.js';

package/next.js

@@ -0,0 +1,34 @@
+// @higuma/eslint-config/next
+// Extends react with Next.js-specific rules.
+// Use for: Next.js app projects.
+
+import nextPlugin from '@next/eslint-plugin-next';
+import tseslint from 'typescript-eslint';
+import react from './react.js';
+
+/** @type {import('eslint').Linter.Config[]} */
+const next = tseslint.config(
+  ...react,
+
+  {
+    files: ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'],
+    plugins: {
+      '@next/next': nextPlugin,
+    },
+    rules: {
+      // Core Next.js rules — all recommended ones as errors
+      ...Object.fromEntries(
+        Object.entries(nextPlugin.configs.recommended.rules ?? {}).map(
+          ([rule, _]) => [rule, 'error']
+        )
+      ),
+
+      // Next.js specific overrides
+      '@next/next/no-html-link-for-pages': 'error',
+      '@next/next/no-img-element': 'error',        // enforce next/image
+      '@next/next/no-sync-scripts': 'error',
+    },
+  }
+);
+
+export default next;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@higuma/eslint-config",
+  "version": "0.1.0",
+  "description": "Shared ESLint flat configs for Higuma Soft projects.",
+  "keywords": ["eslint", "eslint-config", "typescript", "higuma"],
+  "author": "Higuma Soft",
+  "license": "MIT",
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./base": "./base.js",
+    "./react": "./react.js",
+    "./next": "./next.js"
+  },
+  "files": [
+    "*.js",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@next/eslint-plugin-next": "^14.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-plugin-react": "^7.0.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-simple-import-sort": "^12.0.0",
+    "eslint-plugin-unused-imports": "^4.0.0",
+    "globals": "^15.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@next/eslint-plugin-next": {
+      "optional": true
+    },
+    "eslint-plugin-react": {
+      "optional": true
+    },
+    "eslint-plugin-react-hooks": {
+      "optional": true
+    }
+  }
+}

package/react.js

@@ -0,0 +1,50 @@
+// @higuma/eslint-config/react
+// Extends base with React-specific rules.
+// Use for: React SPA projects.
+
+import globals from 'globals';
+import reactPlugin from 'eslint-plugin-react';
+import reactHooks from 'eslint-plugin-react-hooks';
+import tseslint from 'typescript-eslint';
+import base from './base.js';
+
+/** @type {import('eslint').Linter.Config[]} */
+const react = tseslint.config(
+  ...base,
+
+  {
+    files: ['**/*.tsx', '**/*.jsx'],
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+      },
+      parserOptions: {
+        ecmaFeatures: { jsx: true },
+      },
+    },
+    plugins: {
+      react: reactPlugin,
+      'react-hooks': reactHooks,
+    },
+    settings: {
+      react: {
+        // Automatically detect React version
+        version: 'detect',
+      },
+    },
+    rules: {
+      // Hooks
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'error',
+
+      // Props
+      'react/no-unused-prop-types': 'error',
+
+      // React 17+ — no need to import React in scope
+      'react/react-in-jsx-scope': 'off',
+      'react/jsx-uses-react': 'off',
+    },
+  }
+);
+
+export default react;