@jmlweb/eslint-config-base-js 1.0.0

package/README.md

@@ -0,0 +1,237 @@
+# @jmlweb/eslint-config-base-js
+
+[![npm version](https://img.shields.io/npm/v/@jmlweb/eslint-config-base-js)](https://www.npmjs.com/package/@jmlweb/eslint-config-base-js)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18.0.0-339933.svg)](https://nodejs.org/)
+[![ESLint](https://img.shields.io/badge/ESLint-9.0%2B-4B32C3.svg)](https://eslint.org/)
+
+> Base ESLint configuration for JavaScript projects. Foundation for JavaScript-only projects and extended by TypeScript configs. Uses ESLint 9+ flat config format.
+
+## ✨ Features
+
+- 🎯 **JavaScript Support**: Recommended ESLint rules for modern JavaScript (ES modules)
+- 📦 **Import Sorting**: Automatic import and export sorting via `eslint-plugin-simple-import-sort`
+- 🎨 **Prettier Integration**: Disables all ESLint rules that conflict with Prettier
+- 🌐 **Environment Agnostic**: Works for both Node.js and browser projects
+- 🚀 **Flat Config**: Uses ESLint 9+ flat config format (latest stable)
+- 🔧 **Modular Design**: Designed to be extended by other configs (e.g., TypeScript)
+
+## 📦 Installation
+
+```bash
+npm install --save-dev @jmlweb/eslint-config-base-js eslint @eslint/js eslint-config-prettier eslint-plugin-simple-import-sort
+```
+
+## 🚀 Quick Start
+
+Create an `eslint.config.js` file in your project root:
+
+```javascript
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+
+export default [
+  ...baseJsConfig,
+  // Add your project-specific overrides here
+];
+```
+
+## 💡 Examples
+
+### Basic Setup
+
+```javascript
+// eslint.config.js
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+
+export default [...baseJsConfig];
+```
+
+### With Project-Specific Rules
+
+```javascript
+// eslint.config.js
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+
+export default [
+  ...baseJsConfig,
+  {
+    files: ['**/*.test.js', '**/*.spec.js'],
+    rules: {
+      'no-console': 'off', // Allow console in tests
+    },
+  },
+  {
+    ignores: ['dist/', 'build/', 'node_modules/', '*.config.js'],
+  },
+];
+```
+
+### Node.js Project
+
+```javascript
+// eslint.config.js
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+
+export default [
+  ...baseJsConfig,
+  {
+    languageOptions: {
+      globals: {
+        // Add Node.js globals if needed
+        process: 'readonly',
+        __dirname: 'readonly',
+        __filename: 'readonly',
+      },
+    },
+  },
+];
+```
+
+### Browser Project
+
+```javascript
+// eslint.config.js
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+import globals from 'globals';
+
+export default [
+  ...baseJsConfig,
+  {
+    languageOptions: {
+      globals: {
+        ...globals.browser,
+      },
+    },
+  },
+];
+```
+
+## 📋 Configuration Details
+
+### JavaScript Files
+
+The base configuration applies to:
+
+- `**/*.js` - Standard JavaScript files
+- `**/*.mjs` - ES modules
+- `**/*.cjs` - CommonJS files
+
+### Included Rules
+
+- ✅ ESLint recommended rules (`@eslint/js`)
+- ✅ Automatic import/export sorting
+- ✅ Prettier conflict resolution
+
+## 🔄 Import Sorting
+
+The configuration automatically sorts imports and exports. The default sorting order is:
+
+1. **Side effect imports** (e.g., `import 'polyfill'`)
+2. **Node.js built-in modules** (e.g., `import fs from 'fs'`)
+3. **External packages** (e.g., `import react from 'react'`)
+4. **Internal absolute imports** (e.g., `import utils from '@/utils'`)
+5. **Relative imports** (e.g., `import './component'`)
+
+### Example
+
+**Before:**
+
+```javascript
+import './styles.css';
+import { Component } from './component';
+import React from 'react';
+import fs from 'fs';
+import { utils } from '@/utils';
+```
+
+**After auto-fix:**
+
+```javascript
+import './styles.css';
+import fs from 'fs';
+import React from 'react';
+import { utils } from '@/utils';
+import { Component } from './component';
+```
+
+Fix import order automatically:
+
+```bash
+npx eslint --fix .
+```
+
+## 🎨 Prettier Integration
+
+This configuration disables all ESLint rules that conflict with Prettier, allowing Prettier to handle all code formatting.
+
+**Recommended**: Use [`@jmlweb/prettier-config-base`](../prettier-config-base) for consistent formatting.
+
+## 🔗 TypeScript Projects
+
+For TypeScript projects, use [`@jmlweb/eslint-config-base`](../eslint-config-base) which extends this config with strict type checking:
+
+```javascript
+import baseConfig from '@jmlweb/eslint-config-base';
+
+export default [...baseConfig];
+```
+
+## 🔧 Extending the Configuration
+
+You can extend or override the configuration for your specific needs:
+
+```javascript
+import baseJsConfig from '@jmlweb/eslint-config-base-js';
+
+export default [
+  ...baseJsConfig,
+  {
+    files: ['**/*.test.js'],
+    rules: {
+      // Test-specific rules
+      'no-console': 'off',
+    },
+  },
+  {
+    ignores: ['dist/', 'build/', 'node_modules/'],
+  },
+];
+```
+
+## 📝 Usage with Scripts
+
+Add linting scripts to your `package.json`:
+
+```json
+{
+  "scripts": {
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  }
+}
+```
+
+## 📋 Requirements
+
+- **Node.js** >= 18.0.0
+- **ESLint** >= 9.0.0 (flat config format)
+
+## 📦 Peer Dependencies
+
+This package requires the following peer dependencies:
+
+- `eslint` (^9.0.0)
+- `@eslint/js` (^9.0.0)
+- `eslint-config-prettier` (^9.1.0)
+- `eslint-plugin-simple-import-sort` (^12.0.0)
+
+**Note**: This package does NOT require `typescript-eslint` as it's for JavaScript-only projects.
+
+## 🔗 Related Packages
+
+- [`@jmlweb/eslint-config-base`](../eslint-config-base) - TypeScript ESLint config (extends this package)
+- [`@jmlweb/prettier-config-base`](../prettier-config-base) - Prettier config for consistent formatting
+
+## 📄 License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,57 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_js = __toESM(require("@eslint/js"), 1);
+var import_eslint_config_prettier = __toESM(require("eslint-config-prettier"), 1);
+var import_eslint_plugin_simple_import_sort = __toESM(require("eslint-plugin-simple-import-sort"), 1);
+var config = [
+  {
+    files: ["**/*.js", "**/*.mjs", "**/*.cjs"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module"
+    },
+    plugins: {
+      "simple-import-sort": import_eslint_plugin_simple_import_sort.default
+    },
+    rules: {
+      ...import_js.default.configs.recommended.rules,
+      ...import_eslint_config_prettier.default.rules,
+      "simple-import-sort/imports": "error",
+      "simple-import-sort/exports": "error"
+    }
+  }
+];
+var index_default = config;

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+import { Linter } from 'eslint';
+
+/**
+ * Base ESLint configuration for JavaScript files.
+ * This is the foundation that other configs extend.
+ */
+declare const config: Linter.Config[];
+
+export { config as default };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { Linter } from 'eslint';
+
+/**
+ * Base ESLint configuration for JavaScript files.
+ * This is the foundation that other configs extend.
+ */
+declare const config: Linter.Config[];
+
+export { config as default };

package/dist/index.js

@@ -0,0 +1,26 @@
+// src/index.ts
+import js from "@eslint/js";
+import prettierConfig from "eslint-config-prettier";
+import simpleImportSort from "eslint-plugin-simple-import-sort";
+var config = [
+  {
+    files: ["**/*.js", "**/*.mjs", "**/*.cjs"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module"
+    },
+    plugins: {
+      "simple-import-sort": simpleImportSort
+    },
+    rules: {
+      ...js.configs.recommended.rules,
+      ...prettierConfig.rules,
+      "simple-import-sort/imports": "error",
+      "simple-import-sort/exports": "error"
+    }
+  }
+];
+var index_default = config;
+export {
+  index_default as default
+};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@jmlweb/eslint-config-base-js",
+  "version": "1.0.0",
+  "description": "Base ESLint configuration for JavaScript-only projects - foundation extended by @jmlweb/eslint-config-base",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "eslint",
+    "eslint-config",
+    "javascript",
+    "linting",
+    "code-quality"
+  ],
+  "author": "jmlweb",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jmlweb/tooling.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jmlweb/tooling/issues"
+  },
+  "homepage": "https://github.com/jmlweb/tooling/tree/main/packages/eslint-config-base-js#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@eslint/js": "^9.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-simple-import-sort": "^12.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@jmlweb/tsconfig-internal": "workspace:*",
+    "@types/eslint": "^9.6.1",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  }
+}