@adamaho/nopeus-oxlint-config 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nopeus contributors
+
+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,71 @@
+# @adamaho/nopeus-oxlint-config
+
+Ordinary source and test filenames use kebab-case through the built-in
+`unicorn/filename-case` rule: `user-service.ts`, `user-service.test.ts`, and
+`effect.integration.test.ts`. `index.ts` and compound extensions such as `.d.ts`
+retain Oxlint's built-in handling. Framework-mandated filenames should have a
+narrow, documented override in the consuming project's config.
+
+Use ESM imports and exports. `typescript/no-require-imports` rejects `require()`
+(including conditional calls) and `import x = require(...)`;
+`import/no-commonjs` rejects `module.exports` and `exports.*`. The custom plugin
+also rejects TypeScript's `export =` syntax. ESM imports of dependencies that
+internally use CommonJS remain allowed.
+
+Package/test ownership is enforced separately by the custom plugin's `/base`
+and `/effect` presets.
+
+Use package-local Node import aliases for imports that would climb to a parent
+directory. `import/no-relative-parent-imports` rejects `../` and `../../` imports
+in source and tests. Same-directory `./` imports remain allowed.
+
+Define aliases in each package's `package.json`, preserving file extensions:
+
+```json
+{
+  "imports": {
+    "#src/*": "./src/*",
+    "#test/*": "./test/*"
+  }
+}
+```
+
+For example, use `#src/receipts/repository.ts` instead of
+`../../src/receipts/repository.ts`. Across packages, use the target package's
+name and public exports.
+
+Shared configuration selecting built-in Oxlint rules for TypeScript codebases.
+This package has no Effect runtime or LSP dependency.
+
+## Usage
+
+Install the config and its Oxlint peer:
+
+```bash
+pnpm add --save-dev @adamaho/nopeus-oxlint-config oxlint
+```
+
+Extend the base config from an `oxlint.config.ts` file:
+
+```ts
+import base from "@adamaho/nopeus-oxlint-config";
+import { defineConfig } from "oxlint";
+
+export default defineConfig({
+  extends: [base],
+});
+```
+
+Oxlint does not resolve package imports from `.oxlintrc.json`; use a TypeScript
+config when consuming this package.
+
+The package publishes compiled ESM and requires Node.js 22.18 or newer, or
+Node.js 24 or newer.
+
+## Custom Nopeus rules
+
+The separate `@adamaho/nopeus-oxlint-plugin` package implements custom rules.
+Its `/base` preset adds general TypeScript rules without requiring any Effect
+packages. Its `/effect` preset adds Effect syntax checks, including the v4 import
+restrictions previously included in this base config. Use the Effect preset
+for Effect projects. See the [plugin setup](../nopeus-oxlint-plugin/README.md).

package/dist/base.d.mts

@@ -0,0 +1,23 @@
+//#region src/base.d.ts
+declare const _default: {
+  plugins: ("eslint" | "import" | "oxc" | "typescript" | "unicorn")[];
+  rules: {
+    "import/no-commonjs": ["error", {
+      allowRequire: true;
+    }];
+    "import/no-relative-parent-imports": "error";
+    "typescript/no-require-imports": "error";
+    "unicorn/filename-case": ["error", {
+      case: string;
+    }];
+    "eslint/no-debugger": "error";
+    "eslint/no-duplicate-imports": "error";
+  };
+  overrides: {
+    files: string[];
+    plugins: ("eslint" | "import" | "oxc" | "typescript" | "unicorn" | "vitest")[];
+  }[];
+};
+//#endregion
+export { _default as default };
+//# sourceMappingURL=base.d.mts.map

package/dist/base.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.mts","names":[],"sources":["../src/base.ts"],"mappings":""}

package/dist/base.mjs

@@ -0,0 +1,34 @@
+import { defineConfig } from "oxlint";
+//#region src/base.ts
+var base_default = defineConfig({
+	plugins: [
+		"eslint",
+		"typescript",
+		"oxc",
+		"unicorn",
+		"import"
+	],
+	rules: {
+		"import/no-commonjs": ["error", { allowRequire: true }],
+		"import/no-relative-parent-imports": "error",
+		"typescript/no-require-imports": "error",
+		"unicorn/filename-case": ["error", { case: "kebabCase" }],
+		"eslint/no-debugger": "error",
+		"eslint/no-duplicate-imports": "error"
+	},
+	overrides: [{
+		files: ["**/*.{test,spec}.{js,jsx,ts,tsx}"],
+		plugins: [
+			"eslint",
+			"typescript",
+			"oxc",
+			"unicorn",
+			"import",
+			"vitest"
+		]
+	}]
+});
+//#endregion
+export { base_default as default };
+
+//# sourceMappingURL=base.mjs.map

package/dist/base.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.mjs","names":[],"sources":["../src/base.ts"],"sourcesContent":["import { defineConfig } from \"oxlint\";\n\nexport default defineConfig({\n  plugins: [\"eslint\", \"typescript\", \"oxc\", \"unicorn\", \"import\"],\n  rules: {\n    // Let the TypeScript rule own all require forms without duplicate reports.\n    \"import/no-commonjs\": [\"error\", { allowRequire: true }],\n    \"import/no-relative-parent-imports\": \"error\",\n    \"typescript/no-require-imports\": \"error\",\n    \"unicorn/filename-case\": [\"error\", { case: \"kebabCase\" }],\n    \"eslint/no-debugger\": \"error\",\n    \"eslint/no-duplicate-imports\": \"error\",\n  },\n  overrides: [\n    {\n      files: [\"**/*.{test,spec}.{js,jsx,ts,tsx}\"],\n      plugins: [\"eslint\", \"typescript\", \"oxc\", \"unicorn\", \"import\", \"vitest\"],\n    },\n  ],\n});\n"],"mappings":";;AAEA,IAAA,eAAe,aAAa;CAC1B,SAAS;EAAC;EAAU;EAAc;EAAO;EAAW;CAAQ;CAC5D,OAAO;EAEL,sBAAsB,CAAC,SAAS,EAAE,cAAc,KAAK,CAAC;EACtD,qCAAqC;EACrC,iCAAiC;EACjC,yBAAyB,CAAC,SAAS,EAAE,MAAM,YAAY,CAAC;EACxD,sBAAsB;EACtB,+BAA+B;CACjC;CACA,WAAW,CACT;EACE,OAAO,CAAC,kCAAkC;EAC1C,SAAS;GAAC;GAAU;GAAc;GAAO;GAAW;GAAU;EAAQ;CACxE,CACF;AACF,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@adamaho/nopeus-oxlint-config",
+  "version": "0.4.0",
+  "description": "Shared base Oxlint configuration for strict TypeScript codebases.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/adamaho/nopeus.git",
+    "directory": "packages/nopeus-oxlint-config"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/base.d.mts",
+      "import": "./dist/base.mjs"
+    },
+    "./base": {
+      "types": "./dist/base.d.mts",
+      "import": "./dist/base.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@nopeus/tool-tsconfig": "0.0.0",
+    "@nopeus/tool-tsdown-config": "0.0.0",
+    "@types/node": "24.13.3",
+    "oxlint": "1.81.0",
+    "rimraf": "6.1.3",
+    "tsdown": "0.23.0",
+    "typescript": "7.0.2"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.79.0 <2"
+  },
+  "engines": {
+    "node": "^22.18.0 || >=24.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rimraf node_modules dist build .turbo coverage",
+    "lint": "oxlint --config ./src/base.ts src",
+    "tsc": "tsc --noEmit"
+  }
+}