@baicie/eslint-config 0.0.3

package/README.md

@@ -0,0 +1,106 @@
+# @baicie/eslint-config
+
+Unified ESLint configuration package for the Baicie project ecosystem.
+
+## Installation
+
+```bash
+pnpm add -D @baicie/eslint-config
+```
+
+## Usage
+
+### Base Configuration
+
+For general TypeScript projects:
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config';
+
+export default config;
+```
+
+### React Configuration
+
+For React projects:
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config/react';
+
+export default config;
+```
+
+### Node.js Configuration
+
+For backend Node.js projects:
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config/node';
+
+export default config;
+```
+
+### Strict Configuration
+
+For projects requiring stricter code quality:
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config/strict';
+
+export default config;
+```
+
+### NestJS Configuration
+
+For NestJS backend projects:
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config/nestjs';
+
+export default config;
+```
+
+**Features**:
+- Enforces NestJS naming conventions (Controller, Service, Module, etc.)
+- Supports decorators and dependency injection patterns
+- DTO and entity naming conventions
+
+### Vue.js Configuration
+
+For Vue.js frontend projects (Vue 2 / Vue 3):
+
+```js
+// eslint.config.js
+import config from '@baicie/eslint-config/vue';
+
+export default config;
+```
+
+**Features**:
+- Vue 3 Composition API support
+- Vue Single File Component rules
+- TypeScript support in Vue files
+- Enforces `<script setup>` syntax
+
+## Configuration Options
+
+### TypeScript
+
+The base configuration includes TypeScript support via `typescript-eslint`.
+
+### Import Sorting
+
+Imports are automatically sorted and organized by groups.
+
+### Unused Imports
+
+Unused imports are automatically removed on save.
+
+## License
+
+MIT

package/base.js

@@ -0,0 +1,98 @@
+/**
+ * @baicie/eslint-config - Base ESLint Configuration
+ *
+ * This is the foundational ESLint configuration that all other configs extend from.
+ * Provides TypeScript support, import ordering, and common linting rules.
+ */
+import js from '@eslint/js'
+import tseslint from 'typescript-eslint'
+import importPlugin from 'eslint-plugin-import-x'
+import unusedImports from 'eslint-plugin-unused-imports'
+import perfectionist from 'eslint-plugin-perfectionist'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  ...tseslint.configs.stylistic,
+
+  {
+    plugins: {
+      import: importPlugin,
+      'unused-imports': unusedImports,
+      perfectionist: perfectionist,
+    },
+
+    // Disable project-based type checking by default
+    // Consumers should configure parserOptions.project in their own config
+    languageOptions: {
+      parserOptions: {
+        project: null,
+        tsconfigRootDir: null,
+      },
+    },
+
+    rules: {
+      // Delete unused imports
+      'unused-imports/no-unused-imports': 'error',
+      'unused-imports/no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+        },
+      ],
+
+      // TypeScript rules
+      '@typescript-eslint/no-explicit-any': 'warn',
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        {
+          prefer: 'type-imports',
+          disallowTypeAnnotations: false,
+        },
+      ],
+
+      // Import ordering
+      'import/order': [
+        'warn',
+        {
+          groups: [
+            'builtin',
+            'external',
+            'internal',
+            'parent',
+            'sibling',
+            'index',
+            'object',
+            'type',
+          ],
+          'newlines-between': 'always',
+          alphabetize: {
+            order: 'asc',
+            caseInsensitive: true,
+          },
+        },
+      ],
+
+      // Perfectionist for sorting
+      'perfectionist/sort-objects': 'off',
+
+      // Disable conflicting rules
+      'no-unused-vars': 'off',
+    },
+  },
+
+  // Ignore patterns
+  {
+    ignores: [
+      '**/dist/**',
+      '**/node_modules/**',
+      '**/.git/**',
+      '**/temp/**',
+      '**/__tests__/**',
+      '**/*.spec.ts',
+      '**/*.test.ts',
+    ],
+  },
+]

package/nestjs.js

@@ -0,0 +1,124 @@
+/**
+ * @baicie/eslint-config - NestJS ESLint Configuration
+ *
+ * Extends the base configuration with NestJS-specific rules and plugins.
+ * Use this for NestJS backend projects.
+ */
+import base from './base.js'
+import pluginImport from 'eslint-plugin-import'
+
+const micromatch = {
+  name: 'nestjs/micromatch',
+  files: ['**/*.module.ts', '**/*.controller.ts', '**/*.service.ts'],
+  rules: {
+    // NestJS naming conventions
+    '@typescript-eslint/class-naming-convention': [
+      'error',
+      {
+        selector: 'class',
+        format: ['PascalCase'],
+        suffix: [
+          'Controller',
+          'Service',
+          'Module',
+          'Middleware',
+          'Guard',
+          'Pipe',
+          'Interceptor',
+          'Decorator',
+          'ExceptionFilter',
+        ],
+      },
+    ],
+  },
+}
+
+const dtoRules = {
+  name: 'nestjs/dto',
+  files: ['**/*.dto.ts', '**/*.entity.ts', '**/*.interface.ts'],
+  rules: {
+    '@typescript-eslint/naming-convention': [
+      'error',
+      {
+        selector: 'typeLike',
+        format: ['PascalCase'],
+      },
+      {
+        selector: 'property',
+        format: ['camelCase', 'snake_case'],
+        leadingUnderscore: 'allow',
+      },
+    ],
+  },
+}
+
+const decoratedClassRules = {
+  name: 'nestjs/decorated-classes',
+  files: ['**/*.controller.ts', '**/*.service.ts', '**/*.resolver.ts'],
+  rules: {
+    'class-methods-use-this': 'off',
+  },
+}
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  ...base,
+
+  // NestJS-specific rules
+  {
+    plugins: {
+      import: pluginImport,
+    },
+  },
+
+  micromatch,
+  dtoRules,
+  decoratedClassRules,
+
+  {
+    rules: {
+      // Allow dependency injection patterns
+      'no-underscore-dangle': [
+        'error',
+        {
+          allow: ['__', '_id'],
+        },
+      ],
+
+      // Allow parameter decorators
+      'no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+
+      // NestJS controller/service naming
+      '@typescript-eslint/naming-convention': [
+        'error',
+        {
+          selector: 'class',
+          format: ['PascalCase'],
+        },
+        {
+          selector: 'interface',
+          format: ['PascalCase'],
+          custom: {
+            regex: '^I[A-Z]',
+            match: false,
+          },
+        },
+        {
+          selector: 'typeAlias',
+          format: ['PascalCase'],
+        },
+        {
+          selector: 'enumMember',
+          format: ['PascalCase'],
+        },
+      ],
+    },
+  },
+]

package/node.js

@@ -0,0 +1,31 @@
+/**
+ * @baicie/eslint-config - Node.js ESLint Configuration
+ *
+ * Extends the base configuration with Node.js-specific rules.
+ * Use this for backend Node.js projects and CLI tools.
+ */
+import base from './base.js'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  ...base,
+
+  {
+    languageOptions: {
+      globals: {
+        // Node.js globals
+        node: true,
+        // CommonJS globals (for mixed projects)
+        module: 'readonly',
+        require: 'readonly',
+        exports: 'readonly',
+      },
+    },
+
+    rules: {
+      // Node.js specific rules
+      'no-console': 'off',
+      'no-process-exit': 'off',
+    },
+  },
+]

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@baicie/eslint-config",
+  "version": "0.0.3",
+  "type": "module",
+  "exports": {
+    ".": "./base.js",
+    "./react": "./react.js",
+    "./node": "./node.js",
+    "./strict": "./strict.js",
+    "./nestjs": "./nestjs.js",
+    "./vue": "./vue.js"
+  },
+  "peerDependencies": {
+    "eslint": "^9.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint-plugin-import-x": "^4.0.0",
+    "eslint-plugin-perfectionist": "^4.0.0",
+    "eslint-plugin-react": "^7.0.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-unused-imports": "^4.0.0",
+    "eslint-plugin-vue": "^10.0.0",
+    "vue-eslint-parser": "^10.0.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "keywords": [
+    "eslint",
+    "config",
+    "lint",
+    "nestjs",
+    "vue"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}

package/react.js

@@ -0,0 +1,39 @@
+/**
+ * @baicie/eslint-config - React ESLint Configuration
+ *
+ * Extends the base configuration with React-specific rules and plugins.
+ * Use this for React and React Native projects.
+ */
+import base from './base.js'
+import react from 'eslint-plugin-react'
+import hooks from 'eslint-plugin-react-hooks'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  ...base,
+
+  {
+    plugins: {
+      react,
+      'react-hooks': hooks,
+    },
+
+    settings: {
+      react: {
+        version: 'detect',
+      },
+    },
+
+    rules: {
+      // React rules
+      'react/prop-types': 'off',
+      'react/display-name': 'off',
+      'react/jsx-uses-react': 'off',
+      'react/react-in-jsx-scope': 'off',
+
+      // React Hooks rules
+      'react-hooks/rules-of-hooks': 'error',
+      'react-hooks/exhaustive-deps': 'warn',
+    },
+  },
+]

package/strict.js

@@ -0,0 +1,45 @@
+/**
+ * @baicie/eslint-config - Strict ESLint Configuration
+ *
+ * Extends the base configuration with stricter rules for projects
+ * that require more rigorous code quality standards.
+ */
+import base from './base.js'
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  ...base,
+
+  {
+    rules: {
+      // Stricter TypeScript rules
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-non-null-assertion': 'warn',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'error',
+      '@typescript-eslint/no-unnecessary-type-assertion': 'error',
+
+      // Stricter import rules
+      'import/no-cycle': 'error',
+      'import/no-duplicates': 'error',
+      'import/no-unresolved': 'error',
+
+      // Stricter unused vars rules
+      'no-unused-vars': [
+        'error',
+        {
+          argsIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          caughtErrorsIgnorePattern: '^_',
+        },
+      ],
+
+      // Prefer const
+      'prefer-const': 'error',
+
+      // No debugger
+      'no-debugger': 'error',
+    },
+  },
+]

package/vue.js

@@ -0,0 +1,83 @@
+/**
+ * @baicie/eslint-config - Vue.js ESLint Configuration
+ *
+ * Extends the base configuration with Vue.js and Vue 3 Composition API rules.
+ * Use this for Vue.js frontend projects (Vue 2 or Vue 3).
+ */
+import base from './base.js'
+import vuePlugin from 'eslint-plugin-vue'
+import vueParser from 'vue-eslint-parser'
+
+const VueRecommended = {
+  name: 'vue/recommended',
+  files: ['**/*.vue'],
+  ...vuePlugin.configs['vue3-recommended'],
+}
+
+const vueRules = {
+  name: 'vue/rules',
+  files: ['**/*.vue'],
+  rules: {
+    // Vue specific rules
+    'vue/multi-word-component-names': 'off',
+    'vue/no-v-html': 'warn',
+    'vue/require-default-prop': 'off',
+    'vue/require-explicit-emits': 'error',
+    'vue/v-on-event-hyphenation': ['error', 'always', { autofix: true }],
+    'vue/define-emits-declaration': ['error', 'type-based'],
+    'vue/define-macros-emulation': [
+      'error',
+      ['defineProps', 'defineSlots', 'defineEmits', 'defineExpose'],
+    ],
+    'vue/no-unused-vars': 'error',
+
+    // Vue 3 Composition API
+    'vue/component-api-style': ['error', ['script setup']],
+    'vue/component-tags-order': [
+      'error',
+      { order: ['script', 'template', 'style'] },
+    ],
+    'vue/block-order': ['error', { order: ['script', 'template', 'style'] }],
+    'vue/define-props-declaration': ['error', 'type-based'],
+    'vue/no-useless-v-bind': 'error',
+    'vue/no-v-text': 'error',
+    'vue/padding-line-between-blocks': 'error',
+    'vue/prefer-separate-static-class': 'error',
+    'vue/prefer-true-attribute-shorthand': 'error',
+
+    // JSX in Vue (if using)
+    'vue/jsx-uses-vars': 'error',
+  },
+}
+
+const tsxRules = {
+  name: 'vue/tsx',
+  files: ['**/*.tsx'],
+  rules: {
+    // Relaxed rules for TSX files
+    'react/prop-types': 'off',
+  },
+}
+
+/** @type {import('eslint').Linter.Config[]} */
+export default [
+  ...base,
+
+  {
+    name: 'vue/parser',
+    files: ['**/*.vue'],
+    languageOptions: {
+      parser: vueParser,
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+        extraFileExtensions: ['.vue'],
+      },
+    },
+  },
+
+  VueRecommended,
+  vueRules,
+  tsxRules,
+]