@ver0/oxlint-config 1.0.0 → 2.0.1

package/README.md

@@ -18,7 +18,7 @@ A collection of modular [Oxlint](https://oxc.rs/docs/guide/usage/linter) configs
 [`@ver0/eslint-config`](https://github.com/ver0-project/eslint-config) counterpart for the VoidZero stack (Vite+,
 Oxc). Import only what you need and compose via `extends`.
 
-- **JavaScript** — base rules plus `unicorn`, `import`, and `promise` plugins
+- **JavaScript** — base rules plus `unicorn`, `import`, `promise` and `oxc` plugins
 - **TypeScript** — TypeScript rules with type-aware linting
 - **React** — React and hooks rules
 - **Node.js** — Node globals and `node` plugin rules
@@ -27,6 +27,15 @@ Oxc). Import only what you need and compose via `extends`.
 
 Every rule is implemented natively in Rust inside the oxlint binary — configs need **no plugin dependencies** at all.
 
+### Rule philosophy
+
+Configs are **category-driven**: the `correctness`, `suspicious`, `pedantic` and `perf` categories are enabled
+wholesale, so new oxlint rules in those categories roll in automatically with linter updates. The `style` and
+`restriction` categories are deliberately not enabled — `style` contains mutually contradictory rules
+(`no-ternary` vs `prefer-ternary`) and vocabulary policing; instead, a curated set of style and restriction rules is
+enabled explicitly. Org-wide opinions are pinned as explicit `off` entries so they hold even if a consumer enables
+more categories.
+
 ## 🚀 Installation
 
 ```bash
@@ -75,15 +84,16 @@ export default defineConfig({
 
 ## 📦 Available Configs
 
-Each config is a standalone module scoped to its own file globs. Import it to enable, skip it to disable — no options,
-no per-config dependencies.
+Each config is a standalone module; oxlint lints JS and TS uniformly, so modules apply to all lintable files (only
+the vitest module scopes itself to test files). Import to enable, skip to disable — no options, no per-config
+dependencies.
 
-- **JavaScript** (`javascript.js`) — base rules for `*.js(x)` files: ESLint core plus `unicorn`, `import`, and
-  `promise` rules. Always include this one — other configs build on top of it.
+- **JavaScript** (`javascript.js`) — base rules: ESLint core plus `unicorn`, `import`, `promise` and `oxc` rules.
+  Always include this one — other configs build on top of it.
 
-- **TypeScript** (`typescript.js`) — the JS rule set plus `typescript` rules for `*.ts(x)` files. Enables type-aware
-  linting — see [Type-aware linting](#type-aware-linting). Also exports `typescriptUnsafe` to disable strict
-  `no-unsafe-*` type-safety rules:
+- **TypeScript** (`typescript.js`) — `typescript` plugin rules with type-aware linting — see
+  [Type-aware linting](#type-aware-linting). Also exports `typescriptUnsafe` to disable strict `no-unsafe-*`
+  type-safety rules:
 
   ```ts
   import typescript, {typescriptUnsafe} from '@ver0/oxlint-config/typescript.js';
@@ -182,3 +192,33 @@ export default defineConfig({
 	},
 });
 ```
+
+**Your `overrides` losing to the presets?** oxlint merges a consumer's top-level `overrides` _before_ the extended
+configs, so preset overrides (e.g. vitest's plugin enablement for test files) win. Compose your own overrides as the
+last `extends` entry instead — and note that rules of a plugin enabled only inside an override (like `vitest/*`) are
+silently ignored in your override unless it redeclares the plugin:
+
+```ts
+// oxlint.config.ts
+import {defineConfig} from 'oxlint';
+import javascript from '@ver0/oxlint-config/javascript.js';
+import vitest from '@ver0/oxlint-config/vitest.js';
+
+export default defineConfig({
+	extends: [
+		javascript,
+		vitest,
+		{
+			overrides: [
+				{
+					files: ['**/*.test.*'],
+					plugins: ['vitest'],
+					rules: {
+						'vitest/no-disabled-tests': 'off',
+					},
+				},
+			],
+		},
+	],
+});
+```

package/configs/browser-globals.js

@@ -0,0 +1,68 @@
+/**
+ * Browser globals that shadow common identifiers and cause confusing bugs
+ * when referenced without qualification (`window.` prefix).
+ *
+ * Mirrors the `confusing-browser-globals` package.
+ *
+ * @type {string[]}
+ */
+export default [
+	'addEventListener',
+	'blur',
+	'close',
+	'closed',
+	'confirm',
+	'defaultStatus',
+	'defaultstatus',
+	'event',
+	'external',
+	'find',
+	'focus',
+	'frameElement',
+	'frames',
+	'history',
+	'innerHeight',
+	'innerWidth',
+	'length',
+	'location',
+	'locationbar',
+	'menubar',
+	'moveBy',
+	'moveTo',
+	'name',
+	'onblur',
+	'onerror',
+	'onfocus',
+	'onload',
+	'onresize',
+	'onunload',
+	'open',
+	'opener',
+	'opera',
+	'outerHeight',
+	'outerWidth',
+	'pageXOffset',
+	'pageYOffset',
+	'parent',
+	'print',
+	'removeEventListener',
+	'resizeBy',
+	'resizeTo',
+	'screen',
+	'screenLeft',
+	'screenTop',
+	'screenX',
+	'screenY',
+	'scroll',
+	'scrollbars',
+	'scrollBy',
+	'scrollTo',
+	'scrollX',
+	'scrollY',
+	'self',
+	'status',
+	'statusbar',
+	'stop',
+	'toolbar',
+	'top',
+];

package/configs/browser.js

@@ -1,86 +1,14 @@
-import {GLOBS} from '../utils/globs.js';
+import confusingBrowserGlobals from './browser-globals.js';
 
 /** @type {import('oxlint').OxlintConfig} */
 const browser = {
-	plugins: [],
-	categories: {
-		correctness: 'off',
-	},
 	env: {
-		builtin: true,
+		browser: true,
+		es2026: true,
+	},
+	rules: {
+		'no-restricted-globals': ['error', ...confusingBrowserGlobals],
 	},
-	overrides: [
-		{
-			files: [GLOBS.JS, GLOBS.TS],
-			rules: {
-				'no-restricted-globals': [
-					'error',
-					'addEventListener',
-					'blur',
-					'close',
-					'closed',
-					'confirm',
-					'defaultStatus',
-					'defaultstatus',
-					'event',
-					'external',
-					'find',
-					'focus',
-					'frameElement',
-					'frames',
-					'history',
-					'innerHeight',
-					'innerWidth',
-					'length',
-					'location',
-					'locationbar',
-					'menubar',
-					'moveBy',
-					'moveTo',
-					'name',
-					'onblur',
-					'onerror',
-					'onfocus',
-					'onload',
-					'onresize',
-					'onunload',
-					'open',
-					'opener',
-					'opera',
-					'outerHeight',
-					'outerWidth',
-					'pageXOffset',
-					'pageYOffset',
-					'parent',
-					'print',
-					'removeEventListener',
-					'resizeBy',
-					'resizeTo',
-					'screen',
-					'screenLeft',
-					'screenTop',
-					'screenX',
-					'screenY',
-					'scroll',
-					'scrollbars',
-					'scrollBy',
-					'scrollTo',
-					'scrollX',
-					'scrollY',
-					'self',
-					'status',
-					'statusbar',
-					'stop',
-					'toolbar',
-					'top',
-				],
-			},
-			env: {
-				browser: true,
-				es2026: true,
-			},
-		},
-	],
 };
 
 export default browser;

package/configs/javascript.js

@@ -1,263 +1,130 @@
-import {GLOBS} from '../utils/globs.js';
-
 /** @type {import('oxlint').OxlintConfig} */
 const javascript = {
-	plugins: [],
+	plugins: ['import', 'oxc', 'promise', 'unicorn'],
 	categories: {
-		correctness: 'off',
+		correctness: 'error',
+		suspicious: 'error',
+		pedantic: 'error',
+		perf: 'error',
 	},
 	env: {
 		builtin: true,
+		es2026: true,
 	},
-	overrides: [
-		{
-			files: [GLOBS.JS],
-			rules: {
-				'constructor-super': 'error',
-				'for-direction': 'error',
-				'getter-return': 'error',
-				'no-async-promise-executor': 'error',
-				'no-case-declarations': 'error',
-				'no-class-assign': 'error',
-				'no-compare-neg-zero': 'error',
-				'no-cond-assign': 'error',
-				'no-const-assign': 'error',
-				'no-constant-binary-expression': 'error',
-				'no-constant-condition': 'error',
-				'no-control-regex': 'error',
-				'no-debugger': 'error',
-				'no-delete-var': 'error',
-				'no-dupe-class-members': 'error',
-				'no-dupe-else-if': 'error',
-				'no-dupe-keys': 'error',
-				'no-duplicate-case': 'error',
-				'no-empty': 'error',
-				'no-empty-character-class': 'error',
-				'no-empty-pattern': 'error',
-				'no-empty-static-block': 'error',
-				'no-ex-assign': 'error',
-				'no-extra-boolean-cast': 'error',
-				'no-fallthrough': 'error',
-				'no-func-assign': 'error',
-				'no-global-assign': 'error',
-				'no-import-assign': 'error',
-				'no-invalid-regexp': 'error',
-				'no-irregular-whitespace': 'error',
-				'no-loss-of-precision': 'error',
-				'no-misleading-character-class': 'error',
-				'no-new-native-nonconstructor': 'error',
-				'no-nonoctal-decimal-escape': 'error',
-				'no-obj-calls': 'error',
-				'no-prototype-builtins': 'error',
-				'no-redeclare': 'error',
-				'no-regex-spaces': 'error',
-				'no-self-assign': 'error',
-				'no-setter-return': 'error',
-				'no-shadow-restricted-names': 'error',
-				'no-sparse-arrays': 'error',
-				'no-this-before-super': 'error',
-				'no-unassigned-vars': 'error',
-				'no-unexpected-multiline': 'error',
-				'no-unreachable': 'error',
-				'no-unsafe-finally': 'error',
-				'no-unsafe-negation': 'error',
-				'no-unsafe-optional-chaining': 'error',
-				'no-unused-labels': 'error',
-				'no-unused-private-class-members': 'error',
-				'no-unused-vars': 'error',
-				'no-useless-backreference': 'error',
-				'no-useless-catch': 'error',
-				'no-useless-escape': 'error',
-				'no-with': 'error',
-				'preserve-caught-error': 'error',
-				'require-yield': 'error',
-				'use-isnan': 'error',
-				'valid-typeof': 'error',
-				'import/namespace': 'error',
-				'import/default': 'error',
-				'import/no-named-as-default': 'error',
-				'import/no-named-as-default-member': 'error',
-				'import/no-duplicates': [
-					'error',
-					{
-						'prefer-inline': false,
-					},
-				],
-				'promise/always-return': 'error',
-				'promise/no-return-wrap': [
-					'error',
-					{
-						allowReject: true,
-					},
-				],
-				'promise/param-names': 'error',
-				'promise/catch-or-return': 'error',
-				'promise/no-nesting': 'warn',
-				'promise/no-promise-in-callback': 'warn',
-				'promise/no-callback-in-promise': 'warn',
-				'promise/avoid-new': 'off',
-				'promise/no-new-statics': 'error',
-				'promise/valid-params': 'error',
-				'no-negated-condition': 'off',
-				'no-nested-ternary': 'off',
-				'unicorn/catch-error-name': 'error',
-				'unicorn/consistent-assert': 'error',
-				'unicorn/consistent-date-clone': 'error',
-				'unicorn/consistent-empty-array-spread': 'error',
-				'unicorn/consistent-existence-index-check': 'error',
-				'unicorn/consistent-function-scoping': 'off',
-				'unicorn/consistent-template-literal-escape': 'error',
-				'unicorn/custom-error-definition': 'off',
-				'unicorn/empty-brace-spaces': 'error',
-				'unicorn/error-message': 'error',
-				'unicorn/escape-case': 'error',
-				'unicorn/explicit-length-check': 'error',
-				'unicorn/filename-case': 'error',
-				'unicorn/import-style': 'error',
-				'unicorn/new-for-builtins': 'error',
-				'unicorn/no-abusive-eslint-disable': 'error',
-				'unicorn/no-accessor-recursion': 'error',
-				'unicorn/no-anonymous-default-export': 'error',
-				'unicorn/no-array-callback-reference': 'error',
-				'unicorn/no-array-fill-with-reference-type': 'error',
-				'unicorn/no-array-for-each': 'error',
-				'unicorn/no-array-method-this-argument': 'error',
-				'unicorn/no-array-reduce': 'error',
-				'unicorn/no-array-reverse': 'error',
-				'unicorn/no-array-sort': 'error',
-				'unicorn/no-await-expression-member': 'error',
-				'unicorn/no-await-in-promise-methods': 'error',
-				'unicorn/no-console-spaces': 'error',
-				'unicorn/no-document-cookie': 'error',
-				'unicorn/no-empty-file': 'error',
-				'unicorn/no-hex-escape': 'error',
-				'unicorn/no-immediate-mutation': 'error',
-				'unicorn/no-instanceof-builtins': 'error',
-				'unicorn/no-invalid-fetch-options': 'error',
-				'unicorn/no-invalid-remove-event-listener': 'error',
-				'unicorn/no-lonely-if': 'error',
-				'unicorn/no-magic-array-flat-depth': 'error',
-				'unicorn/no-negated-condition': 'error',
-				'unicorn/no-negation-in-equality-check': 'error',
-				'unicorn/no-nested-ternary': 'error',
-				'unicorn/no-new-array': 'error',
-				'unicorn/no-new-buffer': 'error',
-				'unicorn/no-null': 'off',
-				'unicorn/no-object-as-default-parameter': 'error',
-				'unicorn/no-process-exit': 'error',
-				'unicorn/no-single-promise-in-promise-methods': 'error',
-				'unicorn/no-static-only-class': 'error',
-				'unicorn/no-thenable': 'error',
-				'unicorn/no-this-assignment': 'error',
-				'unicorn/no-typeof-undefined': 'error',
-				'unicorn/no-unnecessary-array-flat-depth': 'error',
-				'unicorn/no-unnecessary-array-splice-count': 'error',
-				'unicorn/no-unnecessary-await': 'error',
-				'unicorn/no-unnecessary-slice-end': 'error',
-				'unicorn/no-unreadable-array-destructuring': 'error',
-				'unicorn/no-unreadable-iife': 'error',
-				'unicorn/no-useless-collection-argument': 'error',
-				'unicorn/no-useless-error-capture-stack-trace': 'error',
-				'unicorn/no-useless-fallback-in-spread': 'error',
-				'unicorn/no-useless-length-check': 'error',
-				'unicorn/no-useless-promise-resolve-reject': 'error',
-				'unicorn/no-useless-spread': 'error',
-				'unicorn/no-useless-switch-case': 'error',
-				'unicorn/no-useless-undefined': 'off',
-				'unicorn/no-zero-fractions': 'error',
-				'unicorn/number-literal-case': 'error',
-				'unicorn/numeric-separators-style': 'error',
-				'unicorn/prefer-add-event-listener': 'error',
-				'unicorn/prefer-array-find': 'error',
-				'unicorn/prefer-array-flat': 'error',
-				'unicorn/prefer-array-flat-map': 'error',
-				'unicorn/prefer-array-index-of': 'error',
-				'unicorn/prefer-array-some': 'error',
-				'unicorn/prefer-at': 'error',
-				'unicorn/prefer-bigint-literals': 'error',
-				'unicorn/prefer-blob-reading-methods': 'error',
-				'unicorn/prefer-class-fields': 'error',
-				'unicorn/prefer-classlist-toggle': 'error',
-				'unicorn/prefer-code-point': 'error',
-				'unicorn/prefer-date-now': 'error',
-				'unicorn/prefer-default-parameters': 'error',
-				'unicorn/prefer-dom-node-append': 'error',
-				'unicorn/prefer-dom-node-remove': 'error',
-				'unicorn/prefer-dom-node-text-content': 'error',
-				'unicorn/prefer-event-target': 'error',
-				'unicorn/prefer-export-from': 'error',
-				'unicorn/prefer-global-this': 'error',
-				'unicorn/prefer-import-meta-properties': 'off',
-				'unicorn/prefer-includes': 'error',
-				'unicorn/prefer-keyboard-event-key': 'error',
-				'unicorn/prefer-logical-operator-over-ternary': 'error',
-				'unicorn/prefer-math-min-max': 'error',
-				'unicorn/prefer-math-trunc': 'error',
-				'unicorn/prefer-modern-dom-apis': 'error',
-				'unicorn/prefer-modern-math-apis': 'error',
-				'unicorn/prefer-module': 'error',
-				'unicorn/prefer-native-coercion-functions': 'error',
-				'unicorn/prefer-negative-index': 'error',
-				'unicorn/prefer-node-protocol': 'error',
-				'unicorn/prefer-number-properties': 'error',
-				'unicorn/prefer-object-from-entries': 'error',
-				'unicorn/prefer-optional-catch-binding': 'error',
-				'unicorn/prefer-prototype-methods': 'error',
-				'unicorn/prefer-query-selector': 'error',
-				'unicorn/prefer-reflect-apply': 'error',
-				'unicorn/prefer-regexp-test': 'error',
-				'unicorn/prefer-response-static-json': 'error',
-				'unicorn/prefer-set-has': 'error',
-				'unicorn/prefer-set-size': 'error',
-				'unicorn/prefer-single-call': 'error',
-				'unicorn/prefer-spread': 'error',
-				'unicorn/prefer-string-raw': 'off',
-				'unicorn/prefer-string-replace-all': 'error',
-				'unicorn/prefer-string-slice': 'error',
-				'unicorn/prefer-string-starts-ends-with': 'error',
-				'unicorn/prefer-string-trim-start-end': 'error',
-				'unicorn/prefer-structured-clone': 'error',
-				'unicorn/prefer-ternary': 'off',
-				'unicorn/prefer-top-level-await': 'error',
-				'unicorn/prefer-type-error': 'error',
-				'unicorn/relative-url-style': 'error',
-				'unicorn/require-array-join-separator': 'error',
-				'unicorn/require-module-attributes': 'error',
-				'unicorn/require-module-specifiers': 'error',
-				'unicorn/require-number-to-fixed-digits-argument': 'error',
-				'unicorn/require-post-message-target-origin': 'off',
-				'unicorn/switch-case-braces': 'error',
-				'unicorn/switch-case-break-position': 'error',
-				'unicorn/text-encoding-identifier-case': 'error',
-				'unicorn/throw-new-error': 'error',
-				'capitalized-comments': 'off',
-				'import/first': 'error',
-				'import/no-unassigned-import': 'off',
-				'import/extensions': [
-					'error',
-					'always',
-					{
-						ignorePackages: true,
-					},
-				],
-				'import/no-absolute-path': 'error',
-				'import/no-anonymous-default-export': 'off',
-				'import/no-named-default': 'error',
-				'import/no-webpack-loader-syntax': 'error',
-				'import/no-self-import': 'error',
-				'import/no-cycle': 'off',
-				'import/newline-after-import': 'error',
-				'import/no-amd': 'error',
-				'import/no-empty-named-blocks': 'error',
-				'import/no-mutable-exports': 'error',
-				'promise/prefer-await-to-then': 'error',
+	rules: {
+		'capitalized-comments': 'off',
+		'import/extensions': [
+			'error',
+			'always',
+			{
+				ignorePackages: true,
+			},
+		],
+		'import/first': 'error',
+		'import/max-dependencies': 'off',
+		'import/newline-after-import': 'error',
+		'import/no-amd': 'error',
+		'import/no-anonymous-default-export': 'off',
+		'import/no-cycle': 'off',
+		'import/no-duplicates': [
+			'error',
+			{
+				'prefer-inline': false,
 			},
-			plugins: ['import', 'promise', 'unicorn'],
-			env: {
-				es2026: true,
+		],
+		'import/no-mutable-exports': 'error',
+		'import/no-named-default': 'error',
+		'import/no-unassigned-import': 'off',
+		'import/no-webpack-loader-syntax': 'error',
+		'max-classes-per-file': 'off',
+		'max-depth': 'off',
+		'max-lines': 'off',
+		'max-lines-per-function': 'off',
+		'max-nested-callbacks': 'off',
+		'no-empty': 'error',
+		'no-inline-comments': 'off',
+		'no-negated-condition': 'off',
+		'no-nested-ternary': 'off',
+		'no-regex-spaces': 'error',
+		'no-warning-comments': 'off',
+		'promise/avoid-new': 'off',
+		'promise/catch-or-return': 'error',
+		'promise/no-nesting': 'warn',
+		'promise/no-return-wrap': [
+			'error',
+			{
+				allowReject: true,
 			},
-		},
-	],
+		],
+		'promise/param-names': 'error',
+		'promise/prefer-await-to-then': 'error',
+		'require-unicode-regexp': 'off',
+		'sort-vars': 'off',
+		'unicorn/catch-error-name': 'error',
+		'unicorn/consistent-date-clone': 'error',
+		'unicorn/consistent-existence-index-check': 'error',
+		'unicorn/consistent-function-scoping': 'off',
+		'unicorn/consistent-template-literal-escape': 'error',
+		'unicorn/custom-error-definition': 'off',
+		'unicorn/empty-brace-spaces': 'error',
+		'unicorn/error-message': 'error',
+		'unicorn/filename-case': 'error',
+		'unicorn/import-style': 'error',
+		'unicorn/no-abusive-eslint-disable': 'error',
+		'unicorn/no-anonymous-default-export': 'error',
+		'unicorn/no-array-for-each': 'error',
+		'unicorn/no-array-method-this-argument': 'error',
+		'unicorn/no-array-reduce': 'error',
+		'unicorn/no-await-expression-member': 'error',
+		'unicorn/no-console-spaces': 'error',
+		'unicorn/no-document-cookie': 'error',
+		'unicorn/no-magic-array-flat-depth': 'error',
+		'unicorn/no-nested-ternary': 'error',
+		'unicorn/no-null': 'off',
+		'unicorn/no-process-exit': 'error',
+		'unicorn/no-unreadable-array-destructuring': 'error',
+		'unicorn/no-useless-collection-argument': 'error',
+		'unicorn/no-useless-error-capture-stack-trace': 'error',
+		'unicorn/no-useless-undefined': 'off',
+		'unicorn/no-zero-fractions': 'error',
+		'unicorn/number-literal-case': 'error',
+		'unicorn/numeric-separators-style': 'error',
+		'unicorn/prefer-array-index-of': 'error',
+		'unicorn/prefer-bigint-literals': 'error',
+		'unicorn/prefer-class-fields': 'error',
+		'unicorn/prefer-classlist-toggle': 'error',
+		'unicorn/prefer-default-parameters': 'error',
+		'unicorn/prefer-dom-node-text-content': 'error',
+		'unicorn/prefer-export-from': 'error',
+		'unicorn/prefer-global-this': 'error',
+		'unicorn/prefer-import-meta-properties': 'off',
+		'unicorn/prefer-includes': 'error',
+		'unicorn/prefer-keyboard-event-key': 'error',
+		'unicorn/prefer-logical-operator-over-ternary': 'error',
+		'unicorn/prefer-modern-dom-apis': 'error',
+		'unicorn/prefer-modern-math-apis': 'error',
+		'unicorn/prefer-module': 'error',
+		'unicorn/prefer-negative-index': 'error',
+		'unicorn/prefer-node-protocol': 'error',
+		'unicorn/prefer-number-properties': 'error',
+		'unicorn/prefer-object-from-entries': 'error',
+		'unicorn/prefer-optional-catch-binding': 'error',
+		'unicorn/prefer-reflect-apply': 'error',
+		'unicorn/prefer-response-static-json': 'error',
+		'unicorn/prefer-spread': 'error',
+		'unicorn/prefer-string-raw': 'off',
+		'unicorn/prefer-string-trim-start-end': 'error',
+		'unicorn/prefer-structured-clone': 'error',
+		'unicorn/prefer-ternary': 'off',
+		'unicorn/relative-url-style': 'error',
+		'unicorn/require-array-join-separator': 'error',
+		'unicorn/require-module-attributes': 'error',
+		'unicorn/require-post-message-target-origin': 'off',
+		'unicorn/switch-case-braces': 'error',
+		'unicorn/switch-case-break-position': 'error',
+		'unicorn/text-encoding-identifier-case': 'error',
+		'unicorn/throw-new-error': 'error',
+	},
 };
 
 export default javascript;