@lewishowles/lint-config 0.1.0

package/README.md

@@ -0,0 +1,109 @@
+# @lewishowles/lint-config
+
+Shared oxlint configuration for Lewis Howles projects. One package that every repo extends, so lint setup stops being duplicated and drifting across the ecosystem.
+
+## Installation
+
+```sh
+bun add -d @lewishowles/lint-config @stylistic/eslint-plugin vite-plus
+```
+
+`@stylistic/eslint-plugin` and `vite-plus` are peer dependencies — they must be installed in the consuming project so oxlint can resolve the JS plugins from `node_modules`.
+
+## Usage
+
+Create a `.oxlintrc.json` in your project root that extends the appropriate layer:
+
+### Base layer (all JS/TS projects)
+
+```json
+{
+	"extends": ["./node_modules/@lewishowles/lint-config/base.json"],
+	"ignorePatterns": ["**/dist/*", ".codebase-memory/**"]
+}
+```
+
+### Vue layer (Vue 3 projects)
+
+```json
+{
+	"extends": ["./node_modules/@lewishowles/lint-config/vue.json"],
+	"ignorePatterns": ["**/dist/*", ".codebase-memory/**"]
+}
+```
+
+The Vue layer extends `base.json` internally — you only need to extend `vue.json`.
+
+## Customising
+
+Your `.oxlintrc.json` stub can override rules, add ignore patterns, add overrides, or add plugins on top of the shared layer.
+
+### Overriding a rule
+
+To change the severity or options of a rule defined in the shared layer, redeclare it in your stub — your value wins:
+
+```json
+{
+	"extends": ["./node_modules/@lewishowles/lint-config/base.json"],
+	"rules": {
+		"no-unused-vars": "warn"
+	}
+}
+```
+
+### Adding ignore patterns
+
+Ignore patterns are repo-specific, so they always live in your stub:
+
+```json
+{
+	"extends": ["./node_modules/@lewishowles/lint-config/base.json"],
+	"ignorePatterns": ["**/dist/*", ".codebase-memory/**", "support/**"]
+}
+```
+
+### Adding overrides
+
+Overrides are additive — shared overrides (if any) still apply, and your local ones are appended:
+
+```json
+{
+	"extends": ["./node_modules/@lewishowles/lint-config/base.json"],
+	"overrides": [
+		{
+			"files": ["bin/**/*.js", "src/cli/**/*.js"],
+			"env": { "node": true }
+		},
+		{
+			"files": ["**/*.test.js"],
+			"rules": { "no-unused-vars": "off" }
+		}
+	]
+}
+```
+
+### Adding plugins
+
+Plugins are additive and deduplicated — your local plugins are added to the shared ones. Note that oxlint only supports its built-in plugin names (`oxc`, `typescript`, `unicorn`, `vue`, etc.) — there is no `playwright` or `vitest` plugin. Test-file-specific behaviour is handled via `overrides`, not plugins.
+
+## Layers
+
+| Layer | File | Contents |
+|-------|------|----------|
+| `base` | `base.json` | Correctness rules, `@stylistic` formatting rules, `vite-plus/prefer-vite-plus-imports`, `oxc` + `typescript` + `unicorn` plugins, browser env, node env for config files (`vite.config.*`, `vitest.config.*`, `playwright*.config.*`) |
+| `vue` | `vue.json` | Extends `base`. Adds `vue` plugin, Vue compiler macros as globals, Vue-specific rules |
+
+## What stays repo-local
+
+- `ignorePatterns` — every repo has different build output and tool directories
+- `overrides` for repo-specific directories (e.g. `bin/**/*.js`, `src/cli/**/*.js`, `src/playwright/**/*.js`) — the file paths differ per repo, so they can't be generalised
+- Test-file rule relaxations (e.g. turning off `vite-plus/prefer-vite-plus-imports` in `*.d.ts`)
+- Additional plugins — only repos that need them
+
+## Merge semantics
+
+When a consumer stub adds its own `rules` or `overrides` on top of a shared layer:
+
+- **Rules** shallow-merge by key — the consumer's value wins for any rule defined in both
+- **Overrides** are additive — both shared and local overrides apply
+- **Plugins** are additive — both shared and local plugins are loaded (deduplicated)

package/base.json

@@ -0,0 +1,55 @@
+{
+	"plugins": ["oxc", "typescript", "unicorn"],
+	"jsPlugins": [
+		"@stylistic/eslint-plugin",
+		{
+			"name": "vite-plus",
+			"specifier": "vite-plus/oxlint-plugin"
+		}
+	],
+	"categories": {
+		"correctness": "error"
+	},
+	"env": {
+		"builtin": true,
+		"browser": true
+	},
+	"rules": {
+		"no-case-declarations": "error",
+		"no-empty": "error",
+		"no-fallthrough": "error",
+		"no-prototype-builtins": "error",
+		"no-redeclare": "error",
+		"no-regex-spaces": "error",
+		"no-undef": "error",
+		"no-unexpected-multiline": "error",
+		"no-useless-assignment": "error",
+		"preserve-caught-error": "error",
+
+		"@stylistic/no-confusing-arrow": "error",
+		"@stylistic/padding-line-between-statements": [
+			"error",
+			{ "blankLine": "always", "prev": "const", "next": "let" },
+			{ "blankLine": "always", "prev": "let", "next": "const" },
+			{ "blankLine": "always", "prev": "*", "next": "break" },
+			{ "blankLine": "always", "prev": ["const", "let"], "next": "*" },
+			{ "blankLine": "always", "prev": "*", "next": "return" },
+			{ "blankLine": "any", "prev": "const", "next": "const" },
+			{ "blankLine": "any", "prev": "let", "next": "let" },
+			{ "blankLine": "always", "prev": "multiline-const", "next": "*" },
+			{ "blankLine": "always", "prev": "*", "next": "multiline-const" }
+		],
+
+		"vite-plus/prefer-vite-plus-imports": "error"
+	},
+	"overrides": [
+		{
+			"files": ["vite.config.*", "vitest.config.*", "playwright*.config.*"],
+			"env": { "node": true }
+		}
+	],
+	"options": {
+		"typeAware": false,
+		"typeCheck": false
+	}
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@lewishowles/lint-config",
+	"version": "0.1.0",
+	"description": "Shared oxlint configuration for Lewis Howles projects",
+	"keywords": [
+		"lint",
+		"oxlint",
+		"config",
+		"shared",
+		"eslint",
+		"stylistic"
+	],
+	"homepage": "https://github.com/lewishowles/lint-config#readme",
+	"bugs": "https://github.com/lewishowles/lint-config/issues",
+	"license": "MIT",
+	"author": "Lewis Howles",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/lewishowles/lint-config.git"
+	},
+	"type": "module",
+	"exports": {
+		"./base.json": "./base.json",
+		"./vue.json": "./vue.json"
+	},
+	"files": [
+		"base.json",
+		"vue.json",
+		"README.md"
+	],
+	"peerDependencies": {
+		"@stylistic/eslint-plugin": "*",
+		"vite-plus": "*"
+	},
+	"devDependencies": {
+		"publint": "^0.3.21"
+	},
+	"scripts": {
+		"publint": "publint"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"engines": {
+		"node": ">=20"
+	}
+}

package/vue.json

@@ -0,0 +1,30 @@
+{
+	"extends": ["./base.json"],
+	"plugins": ["vue"],
+	"globals": {
+		"defineEmits": "readonly",
+		"defineExpose": "readonly",
+		"defineModel": "readonly",
+		"defineOptions": "readonly",
+		"defineProps": "readonly",
+		"defineSlots": "readonly",
+		"withDefaults": "readonly"
+	},
+	"rules": {
+		"vue/no-arrow-functions-in-watch": "error",
+		"vue/no-deprecated-data-object-declaration": "error",
+		"vue/no-deprecated-delete-set": "error",
+		"vue/no-deprecated-destroyed-lifecycle": "error",
+		"vue/no-deprecated-events-api": "error",
+		"vue/no-deprecated-model-definition": "error",
+		"vue/no-deprecated-vue-config-keycodes": "error",
+		"vue/no-export-in-script-setup": "error",
+		"vue/no-lifecycle-after-await": "error",
+		"vue/prefer-import-from-vue": "error",
+		"vue/return-in-computed-property": "error",
+		"vue/valid-define-emits": "error",
+		"vue/valid-define-props": "error",
+		"vue/no-multiple-slot-args": "warn",
+		"vue/no-required-prop-with-default": "warn"
+	}
+}