@fdhl/oxlint-config 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Muhammad Fadhil
+
+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,70 @@
+# `@fdhl/oxlint-config`
+
+An opinionated, production-ready [Oxlint](https://oxc.rs/docs/guide/usage/linter) configuration for TypeScript and React projects. Requires `oxlint >= 1.51.0`.
+
+## Quick Start
+
+```bash
+pnpm add -D @fdhl/oxlint-config oxlint
+# or
+npm install --save-dev @fdhl/oxlint-config oxlint
+```
+
+Create `oxlint.config.js` in your project root:
+
+```js
+import config from "@fdhl/oxlint-config";
+
+export default config;
+```
+
+Run the linter:
+
+```bash
+npx oxlint .
+```
+
+## What's Included
+
+### Oxlint Native Plugins
+
+| Plugin       | Purpose                         |
+| ------------ | ------------------------------- |
+| `typescript` | TypeScript-specific rules       |
+| `unicorn`    | Modern JS best practices        |
+| `react`      | React and React DOM rules       |
+| `node`       | Node.js best practices          |
+| `import`     | Import consistency and ordering |
+
+### JS Plugins (ESLint-compatible, bridged via oxlint)
+
+| Plugin                                                                                                                                    | Purpose                              |
+| ----------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------ |
+| [`eslint-plugin-perfectionist`](https://perfectionist.dev)                                                                                | Sorted imports, exports, named items |
+| [`eslint-plugin-react-dom`](https://github.com/Rel1cx/eslint-react/tree/main/packages/plugins/eslint-plugin-react-dom)                    | React DOM-specific rules             |
+| [`eslint-plugin-react-hooks`](https://github.com/facebook/react/tree/main/packages/eslint-plugin-react-hooks)                            | Rules of hooks, exhaustive deps      |
+| [`eslint-plugin-unused-imports`](https://github.com/sweepline/eslint-plugin-unused-imports)                                               | Auto-remove unused imports and vars  |
+| [`eslint-plugin-no-only-tests`](https://github.com/levibuzolic/eslint-plugin-no-only-tests)                                               | Prevent `.only` in test files        |
+
+## Design Principles
+
+1. **Explicit Opt-in Rules** — Oxlint's `correctness` category is disabled; only hand-picked rules are enabled, so you know exactly what's enforced
+2. **TypeScript-aware** — Bans `@ts-ignore`, prevents unsafe type patterns, enforces `prefer-as-const`
+3. **Modern JS** — ES2024+, prefers `at()`, `includes()`, `structuredClone()`, node protocol imports
+4. **React Best Practices** — Blocks legacy APIs (`findDOMNode`, `dangerouslySetInnerHTML`), enforces hooks rules
+5. **Import Hygiene** — Sorted imports/exports, no duplicates, unused imports auto-removed
+6. **Developer UX** — Blocks `@nocommit` tags and `.only` tests from reaching production
+
+## VS Code Setup
+
+Install the [Oxlint VS Code extension](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode), then add to `.vscode/settings.json`:
+
+```json
+{
+  "oxc.enable": true
+}
+```
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,3 @@
+declare const config: import("oxlint").OxlintConfig;
+
+export default config;

package/index.js

@@ -0,0 +1,165 @@
+import { defineConfig } from 'oxlint';
+
+import { nodeConfig } from './node';
+import { perfectionistConfig } from './perfectionist';
+import { reactConfig } from './react';
+import { typescriptConfig } from './typescript';
+import { unicornConfig } from './unicorn';
+
+export const config = defineConfig({
+  plugins: ['typescript', 'unicorn', 'react', 'node', 'import'],
+  sortImports: {
+    order: 'asc',
+    type: 'natural'
+  },
+  jsPlugins: [
+    'eslint-plugin-perfectionist',
+    'eslint-plugin-react-dom',
+    'eslint-plugin-no-only-tests',
+    'eslint-plugin-unused-imports'
+  ],
+  categories: {
+    correctness: 'off'
+  },
+  env: {
+    builtin: true,
+    es2024: true,
+    browser: true,
+    node: true
+  },
+  rules: {
+    ...nodeConfig,
+    ...perfectionistConfig,
+    ...reactConfig,
+    ...typescriptConfig,
+    ...unicornConfig,
+    'constructor-super': 'error',
+    'for-direction': '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',
+      {
+        builtinGlobals: false
+      }
+    ],
+    '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-unexpected-multiline': '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-useless-backreference': 'error',
+    'no-useless-catch': 'error',
+    'no-useless-escape': 'error',
+    'no-with': 'error',
+    'require-yield': 'error',
+    'use-isnan': [
+      'error',
+      {
+        enforceForIndexOf: true,
+        enforceForSwitchCase: true
+      }
+    ],
+    'valid-typeof': 'error',
+    curly: 'error',
+    'import/consistent-type-specifier-style': ['error', 'top-level'],
+    'import/first': 'error',
+    'import/no-duplicates': 'error',
+    'import/no-mutable-exports': 'error',
+    'import/no-named-default': 'error',
+    'no-console': [
+      'error',
+      {
+        allow: ['warn', 'error']
+      }
+    ],
+    'no-only-tests/no-only-tests': 'error',
+    'no-useless-rename': 'error',
+    'no-useless-return': 'error',
+    'no-var': 'error',
+    'no-warning-comments': [
+      'error',
+      {
+        terms: ['@nocommit']
+      }
+    ],
+    'prefer-const': 'error',
+    'prefer-spread': 'error',
+    'unused-imports/no-unused-imports': 'error',
+    'unused-imports/no-unused-vars': [
+      'error',
+      {
+        args: 'after-used',
+        argsIgnorePattern: '^_',
+        ignoreRestSiblings: true,
+        vars: 'all',
+        varsIgnorePattern: '^_'
+      }
+    ],
+    'no-use-before-define': [
+      'error',
+      {
+        classes: false,
+        functions: false,
+        variables: true
+      }
+    ]
+  },
+  overrides: [
+    {
+      files: ['**/*.ts', '**/*.tsx', '**/*.mts', '**/*.cts'],
+      rules: {
+        'constructor-super': 'off',
+        'no-class-assign': 'off',
+        'no-dupe-class-members': 'off',
+        'no-func-assign': 'off',
+        'no-import-assign': 'off',
+        'no-new-native-nonconstructor': 'off',
+        'no-obj-calls': 'off',
+        'no-redeclare': 'off',
+        'no-setter-return': 'off',
+        'no-unsafe-negation': 'off',
+        'no-with': 'off',
+        'prefer-rest-params': 'error'
+      }
+    }
+  ]
+});

package/node.js

@@ -0,0 +1,6 @@
+export const nodeConfig = {
+  "node/handle-callback-err": ["error", "^(err|error)$"],
+  "node/no-exports-assign": "error",
+  "node/no-new-require": "error",
+  "node/no-path-concat": "error",
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@fdhl/oxlint-config",
+  "version": "1.0.0",
+  "description": "An opinionated Oxlint config for TypeScript projects",
+  "keywords": [
+    "autofix",
+    "config",
+    "defaults",
+    "oxlint"
+  ],
+  "license": "MIT",
+  "author": "Muhammad Fadhil <mail@mfadhil.me>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/technowizard/oxlint-config.git"
+  },
+  "type": "module",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "scripts": {
+    "format": "oxfmt --write .",
+    "lint": "oxlint ."
+  },
+  "dependencies": {
+    "eslint-plugin-no-only-tests": "^3.3.0",
+    "eslint-plugin-perfectionist": "^5.7.0",
+    "eslint-plugin-react-dom": "^3.0.0",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-unused-imports": "^4.4.1"
+  },
+  "devDependencies": {
+    "oxfmt": "^0.42.0",
+    "oxlint": "^1.57.0"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.51.0"
+  }
+}

package/perfectionist.js

@@ -0,0 +1,23 @@
+export const perfectionistConfig = {
+  "perfectionist/sort-exports": [
+    "error",
+    {
+      order: "asc",
+      type: "natural",
+    },
+  ],
+  "perfectionist/sort-named-exports": [
+    "error",
+    {
+      order: "asc",
+      type: "natural",
+    },
+  ],
+  "perfectionist/sort-named-imports": [
+    "error",
+    {
+      order: "asc",
+      type: "natural",
+    },
+  ],
+};

package/react.js

@@ -0,0 +1,23 @@
+export const reactConfig = {
+  "react/jsx-no-comment-textnodes": "warn",
+  "react/jsx-no-duplicate-props": "warn",
+  "react/no-array-index-key": "warn",
+  "react/no-clone-element": "warn",
+  "react/no-direct-mutation-state": "error",
+  "react/no-redundant-should-component-update": "error",
+  "react/no-string-refs": "error",
+  "react-dom/no-dangerously-set-innerhtml": "warn",
+  "react-dom/no-dangerously-set-innerhtml-with-children": "error",
+  "react-dom/no-find-dom-node": "error",
+  "react-dom/no-flush-sync": "error",
+  "react-dom/no-hydrate": "error",
+  "react-dom/no-namespace": "error",
+  "react-dom/no-render": "error",
+  "react-dom/no-render-return-value": "error",
+  "react-dom/no-script-url": "warn",
+  "react-dom/no-unsafe-iframe-sandbox": "warn",
+  "react-dom/no-use-form-state": "error",
+  "react-dom/no-void-elements-with-children": "error",
+  "react-hooks/rules-of-hooks": "error",
+  "react-hooks/exhaustive-deps": "warn",
+};

package/typescript.js

@@ -0,0 +1,35 @@
+export const typescriptConfig = {
+  "@typescript-eslint/ban-ts-comment": [
+    "error",
+    {
+      "ts-expect-error": "allow-with-description",
+    },
+  ],
+  "no-array-constructor": "error",
+  "@typescript-eslint/no-duplicate-enum-values": "error",
+  "@typescript-eslint/no-empty-object-type": [
+    "error",
+    {
+      allowInterfaces: "always",
+    },
+  ],
+  "@typescript-eslint/no-extra-non-null-assertion": "error",
+  "@typescript-eslint/no-import-type-side-effects": "error",
+  "@typescript-eslint/no-misused-new": "error",
+  "@typescript-eslint/no-non-null-asserted-optional-chain": "error",
+  "@typescript-eslint/no-require-imports": "error",
+  "@typescript-eslint/no-unnecessary-type-constraint": "error",
+  "@typescript-eslint/no-unsafe-declaration-merging": "error",
+  "@typescript-eslint/no-unsafe-function-type": "error",
+  "no-unused-expressions": [
+    "error",
+    {
+      allowShortCircuit: true,
+      allowTaggedTemplates: true,
+      allowTernary: true,
+    },
+  ],
+  "@typescript-eslint/no-wrapper-object-types": "error",
+  "@typescript-eslint/prefer-as-const": "error",
+  "@typescript-eslint/prefer-namespace-keyword": "error",
+};

package/unicorn.js

@@ -0,0 +1,42 @@
+export const unicornConfig = {
+  "unicorn/catch-error-name": "error",
+  "unicorn/consistent-empty-array-spread": "error",
+  "unicorn/consistent-function-scoping": "error",
+  "unicorn/error-message": "error",
+  "unicorn/escape-case": "error",
+  "unicorn/new-for-builtins": "error",
+  "unicorn/no-hex-escape": "error",
+  "unicorn/no-instanceof-builtins": "error",
+  "unicorn/no-invalid-fetch-options": "error",
+  "unicorn/no-magic-array-flat-depth": "error",
+  "unicorn/no-new-array": "error",
+  "unicorn/no-new-buffer": "error",
+  "unicorn/no-typeof-undefined": "error",
+  "unicorn/no-unnecessary-slice-end": "error",
+  "unicorn/no-useless-promise-resolve-reject": "error",
+  "unicorn/no-useless-spread": "error",
+  "unicorn/number-literal-case": "error",
+  "unicorn/numeric-separators-style": "error",
+  "unicorn/prefer-array-flat-map": "error",
+  "unicorn/prefer-array-index-of": "error",
+  "unicorn/prefer-array-some": "error",
+  "unicorn/prefer-at": "error",
+  "unicorn/prefer-dom-node-append": "error",
+  "unicorn/prefer-dom-node-text-content": "error",
+  "unicorn/prefer-includes": "error",
+  "unicorn/prefer-native-coercion-functions": "error",
+  "unicorn/prefer-node-protocol": "error",
+  "unicorn/prefer-number-properties": "error",
+  "unicorn/prefer-optional-catch-binding": "error",
+  "unicorn/prefer-set-size": "error",
+  "unicorn/prefer-string-raw": "error",
+  "unicorn/prefer-string-replace-all": "error",
+  "unicorn/prefer-string-slice": "error",
+  "unicorn/prefer-string-starts-ends-with": "error",
+  "unicorn/prefer-structured-clone": "error",
+  "unicorn/prefer-ternary": "error",
+  "unicorn/prefer-top-level-await": "error",
+  "unicorn/prefer-type-error": "error",
+  "unicorn/text-encoding-identifier-case": "error",
+  "unicorn/throw-new-error": "error",
+};