@yoltra/eslint-config-base 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Yoltra — Copyright (c) 2026 Manu Ramirez <@pixerael>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,30 @@
+# @yoltra/eslint-config-base
+
+Shared ESLint **flat config** for Node.js + browser TypeScript libraries in the Yoltra monorepo.
+
+## Install
+
+```sh
+npm install --save-dev @yoltra/eslint-config-base eslint typescript-eslint
+```
+
+`eslint` is a peer dependency (`>=9`).
+
+## Usage
+
+In your `eslint.config.js` (flat config):
+
+```js
+import base from "@yoltra/eslint-config-base";
+
+export default [
+  ...base,
+  // your project-specific overrides
+];
+```
+
+For React projects, use [`@yoltra/eslint-config-react`](../eslint-config-react), which extends this base.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,71 @@
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+import globals from "globals";
+
+/**
+ * Shared ESLint flat config for Node.js + browser TypeScript libraries.
+ *
+ * Extends:
+ *   - @eslint/js recommended
+ *   - typescript-eslint recommended
+ *
+ * Targets files matching **\/*.{ts,tsx,mts,cts}.
+ *
+ * Usage in a consuming package:
+ *
+ *   // eslint.config.mjs
+ *   import baseConfig from "@yoltra/eslint-config-base";
+ *   export default baseConfig;
+ *
+ * Or extend with package-specific overrides:
+ *
+ *   // eslint.config.mjs
+ *   import baseConfig from "@yoltra/eslint-config-base";
+ *   export default [
+ *     ...baseConfig,
+ *     { rules: { "no-console": "off" } },
+ *   ];
+ *
+ * @type {import("typescript-eslint").Config}
+ */
+export default tseslint.config(
+  {
+    // Patterns that should never be linted
+    ignores: [
+      "dist/**",
+      "coverage/**",
+      "node_modules/**",
+      ".typedoc/**",
+      "**/*.d.ts",
+    ],
+  },
+  {
+    files: ["**/*.{ts,tsx,mts,cts}"],
+    extends: [js.configs.recommended, ...tseslint.configs.recommended],
+    languageOptions: {
+      ecmaVersion: 2020,
+      globals: {
+        ...globals.browser,
+        ...globals.node,
+      },
+    },
+    rules: {
+      // Downgrade to a warning so it does not block PRs when experimenting,
+      // but still surfaces typing gaps in code review.
+      "@typescript-eslint/no-explicit-any": "warn",
+
+      // Allow unused vars/args that are intentionally prefixed with underscore.
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+          caughtErrorsIgnorePattern: "^_",
+        },
+      ],
+
+      // Allow console.warn and console.error for library-level diagnostics.
+      "no-console": ["warn", { allow: ["warn", "error"] }],
+    },
+  },
+);

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@yoltra/eslint-config-base",
+  "version": "0.2.1",
+  "description": "Shared ESLint flat config for Node.js + browser TypeScript libraries",
+  "license": "MIT",
+  "author": {
+    "name": "Manu Ramirez <@pixerael>",
+    "email": "manu@yoltra.dev"
+  },
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js"
+  },
+  "files": [
+    "index.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "peerDependencies": {
+    "eslint": ">=9.0.0"
+  },
+  "dependencies": {
+    "@eslint/js": "^9.30.1",
+    "globals": "^16.3.0",
+    "typescript-eslint": "^8.35.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "exit 0",
+    "lint": "exit 0"
+  }
+}