@librestock/eslint-config 0.1.0

package/base.js

@@ -0,0 +1,168 @@
+import js from '@eslint/js'
+import prettierConfig from 'eslint-config-prettier'
+import pluginImport from 'eslint-plugin-import'
+import pluginPromise from 'eslint-plugin-promise'
+import pluginUnicorn from 'eslint-plugin-unicorn'
+import globals from 'globals'
+import tseslint from 'typescript-eslint'
+
+/**
+ * Base ESLint configuration for LibreStock monorepo.
+ * Modules should import this and extend with their own rules.
+ *
+ * Usage:
+ *   import baseConfig from '@librestock/eslint-config'
+ *   export default tseslint.config(...baseConfig, { ...moduleSpecificRules })
+ */
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommendedTypeChecked,
+  ...tseslint.configs.stylisticTypeChecked,
+
+  // Global language options (modules can override)
+  {
+    languageOptions: {
+      ecmaVersion: 2024,
+      sourceType: 'module',
+      globals: {
+        ...globals.node,
+        ...globals.es2021,
+      },
+      parserOptions: {
+        project: true,
+      },
+    },
+  },
+
+  // Import plugin configuration
+  {
+    plugins: {
+      import: pluginImport,
+    },
+    rules: {
+      'import/order': 'error',
+      'import/no-duplicates': 'error',
+      'import/no-cycle': 'error',
+      'import/no-self-import': 'error',
+      'import/first': 'error',
+      'import/newline-after-import': 'error',
+      'import/no-mutable-exports': 'error',
+    },
+  },
+
+  // Code quality plugins
+  {
+    plugins: {
+      unicorn: pluginUnicorn,
+      promise: pluginPromise,
+    },
+    rules: {
+      // Unicorn rules
+      'unicorn/better-regex': 'error',
+      'unicorn/catch-error-name': 'error',
+      'unicorn/no-abusive-eslint-disable': 'error',
+      'unicorn/prefer-node-protocol': 'error',
+      'unicorn/prefer-number-properties': 'error',
+      'unicorn/prefer-optional-catch-binding': 'error',
+      'unicorn/prevent-abbreviations': 'off',
+      'unicorn/no-null': 'off',
+
+      // Promise rules
+      'promise/always-return': 'error',
+      'promise/catch-or-return': 'error',
+      'promise/no-return-wrap': 'error',
+      'promise/param-names': 'error',
+      'promise/no-nesting': 'warn',
+    },
+  },
+
+  // TypeScript rules
+  {
+    rules: {
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          args: 'all',
+          argsIgnorePattern: '^_',
+          caughtErrors: 'all',
+          caughtErrorsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+        },
+      ],
+      '@typescript-eslint/consistent-type-imports': [
+        'error',
+        {
+          prefer: 'type-imports',
+          fixStyle: 'inline-type-imports',
+          disallowTypeAnnotations: false,
+        },
+      ],
+      '@typescript-eslint/no-floating-promises': 'error',
+      '@typescript-eslint/await-thenable': 'error',
+      '@typescript-eslint/require-await': 'error',
+      '@typescript-eslint/no-misused-promises': [
+        'error',
+        {
+          checksVoidReturn: {
+            attributes: false,
+          },
+        },
+      ],
+      // Disable overly strict unsafe rules - impractical with third-party libraries
+      '@typescript-eslint/no-unsafe-assignment': 'off',
+      '@typescript-eslint/no-unsafe-member-access': 'off',
+      '@typescript-eslint/no-unsafe-call': 'off',
+      '@typescript-eslint/no-unsafe-return': 'off',
+      '@typescript-eslint/no-unsafe-argument': 'off',
+    },
+  },
+
+  // General JavaScript rules
+  {
+    rules: {
+      'no-console': ['warn', { allow: ['warn', 'error', 'info'] }],
+      'no-debugger': 'error',
+      'no-var': 'error',
+      'prefer-const': 'error',
+      'prefer-arrow-callback': 'error',
+      'prefer-template': 'error',
+      'object-shorthand': 'error',
+      'prefer-destructuring': ['error', { object: true, array: false }],
+      'prefer-object-spread': 'error',
+      'prefer-rest-params': 'error',
+      'prefer-spread': 'error',
+      curly: ['error', 'all'],
+      eqeqeq: ['error', 'always', { null: 'ignore' }],
+      'no-else-return': ['error', { allowElseIf: false }],
+      'no-useless-return': 'error',
+      'no-useless-rename': 'error',
+      'no-throw-literal': 'error',
+    },
+  },
+
+  // Config/script file overrides
+  {
+    files: ['**/*.config.{js,ts,mjs,mts}', '**/scripts/**/*'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+
+  // Prettier should be last
+  prettierConfig,
+
+  // Common ignore patterns
+  {
+    ignores: [
+      '**/node_modules/**',
+      'dist/**',
+      'build/**',
+      'coverage/**',
+      '**/.turbo/**',
+      '**/.cache/**',
+      '*.min.js',
+    ],
+  },
+)

package/index.js

@@ -0,0 +1,4 @@
+// Re-export base config as default
+export { default } from './base.js'
+export { default as base } from './base.js'
+export { default as nestjs } from './nestjs.js'

package/nestjs.js

@@ -0,0 +1,30 @@
+import baseConfig from './base.js'
+import tseslint from 'typescript-eslint'
+
+export default tseslint.config(
+  ...baseConfig,
+
+  // NestJS specific rules
+  {
+    rules: {
+      '@typescript-eslint/interface-name-prefix': 'off',
+      '@typescript-eslint/explicit-function-return-type': 'off',
+      '@typescript-eslint/explicit-module-boundary-types': 'off',
+      '@typescript-eslint/no-explicit-any': 'warn',
+    },
+  },
+
+  // Test files
+  {
+    files: ['**/*.spec.ts', '**/*.e2e-spec.ts'],
+    rules: {
+      '@typescript-eslint/no-explicit-any': 'off',
+      'no-console': 'off',
+    },
+  },
+
+  // Ignore patterns
+  {
+    ignores: ['dist/**', 'node_modules/**'],
+  },
+)

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@librestock/eslint-config",
+  "version": "0.1.0",
+  "description": "Shared ESLint configurations for LibreStock Inventory monorepo",
+  "license": "AGPL-3.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/librestock/packages.git",
+    "directory": "eslint-config"
+  },
+  "type": "module",
+  "main": "./index.js",
+  "exports": {
+    ".": "./index.js",
+    "./base": "./base.js",
+    "./nestjs": "./nestjs.js"
+  },
+  "files": [
+    "*.js"
+  ],
+  "peerDependencies": {
+    "eslint": ">=8.0.0",
+    "prettier": ">=3.0.0",
+    "typescript": ">=5.0.0"
+  },
+  "dependencies": {
+    "@eslint/js": "^9.39.2",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-promise": "^7.2.1",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "globals": "^16.5.0",
+    "typescript-eslint": "^8.50.1"
+  }
+}