@letstri/oxc-config 0.1.0

package/README.md

@@ -0,0 +1,247 @@
+# Oxlint and Oxfmt configs
+
+Opinionated, shared [oxlint](https://oxc.rs/docs/guide/usage/linter.html) and [oxfmt](https://oxc.rs) config, in the spirit of [@antfu/eslint-config](https://github.com/antfu/eslint-config).
+
+> [!NOTE]
+> This is an **opinionated** config — it ships a curated set of rules and
+> formatting defaults meant to work out of the box. Override anything you
+> disagree with via the [`override`](#overrides) option.
+
+## Install
+
+```bash
+pnpm add -D @letstri/oxc-config oxlint oxfmt
+```
+
+## AI setup prompt
+
+Paste this into Claude Code, Cursor, or any coding agent to wire everything up:
+
+<details>
+<summary>Show prompt</summary>
+
+````text
+Set up @letstri/oxc-config (oxlint + oxfmt) in this project:
+
+1. Install dev deps: `@letstri/oxc-config oxlint oxfmt`.
+2. Remove ESLint and Prettier: their configs, deps, and scripts.
+3. Create `oxlint.config.ts`:
+   ```ts
+   import { oxlintConfig } from '@letstri/oxc-config'
+
+   export default oxlintConfig()
+   ```
+4. Create `oxfmt.config.ts`:
+   ```ts
+   import { oxfmtConfig } from '@letstri/oxc-config'
+
+   export default oxfmtConfig()
+   ```
+5. Add package.json scripts:
+   - "lint": "oxlint"
+   - "lint:fix": "oxlint --fix"
+   - "format": "oxfmt"
+   - "format:check": "oxfmt --check"
+6. Framework plugins auto-enable from the nearest package.json. If a framework
+   dep (react/vue/next/vitest/jest/typescript) lives in a nested workspace,
+   enable it manually, e.g. `oxlintConfig({ vue: true })`.
+7. Add the VS Code and Zed editor settings from the @letstri/oxc-config README.
+8. Run `pnpm lint` and `pnpm format` and fix anything reported.
+````
+
+</details>
+
+## Usage
+
+`oxlint.config.ts`:
+
+```ts
+import { oxlintConfig } from '@letstri/oxc-config'
+
+export default oxlintConfig()
+```
+
+`oxfmt.config.ts`:
+
+```ts
+import { oxfmtConfig } from '@letstri/oxc-config'
+
+export default oxfmtConfig()
+```
+
+### Plugins
+
+Framework plugins are enabled automatically by detecting dependencies in the
+nearest `package.json` (`typescript`, `react`, `vue`, `next`, `vitest`, `jest`,
+`tailwind`). Toggle any of them manually — useful when the dependency lives in a
+nested workspace such as `apps/web/package.json`:
+
+```ts
+export default oxlintConfig({
+  vue: true, // force on
+  jest: false, // force off
+})
+```
+
+### Tailwind
+
+`tailwind: true` enables [`eslint-plugin-better-tailwindcss`](https://github.com/schoero/eslint-plugin-better-tailwindcss)
+(auto-detected from a `tailwindcss` dependency). The plugin is an **optional peer
+dependency** — install it yourself:
+
+```bash
+pnpm add -D eslint-plugin-better-tailwindcss
+```
+
+If Tailwind is enabled but the plugin is missing, the config logs a reminder and
+skips Tailwind linting instead of crashing. Point the plugin at your Tailwind
+entry CSS so it can resolve class names:
+
+```ts
+export default oxlintConfig({
+  tailwind: true,
+  override: {
+    settings: {
+      'better-tailwindcss': {
+        entryPoint: 'src/styles/globals.css',
+      },
+    },
+  },
+})
+```
+
+### Overrides
+
+`override` is deep-merged over the base config via [defu](https://github.com/unjs/defu):
+
+```ts
+export default oxlintConfig({
+  override: {
+    rules: {
+      'no-console': 'off',
+    },
+  },
+})
+```
+
+## Editor setup
+
+Both editors use the official [oxc](https://oxc.rs) tooling — `oxlint` for
+linting and `oxfmt` for formatting — replacing ESLint and Prettier.
+
+### VS Code
+
+Install the [`oxc.oxc-vscode`](https://marketplace.visualstudio.com/items?itemName=oxc.oxc-vscode)
+extension.
+
+<details>
+<summary>Show VS Code config</summary>
+
+`.vscode/extensions.json`:
+
+```json
+{
+  "recommendations": ["oxc.oxc-vscode"]
+}
+```
+
+`.vscode/settings.json`:
+
+```jsonc
+{
+  "oxc.configPath": "oxlint.config.ts",
+  "oxc.fmt.configPath": "oxfmt.config.ts",
+  "oxc.typeAware": true,
+  "oxc.unusedDisableDirectives": "deny",
+  "oxc.enable": true,
+  "prettier.enable": false,
+  "editor.defaultFormatter": "oxc.oxc-vscode",
+  "editor.formatOnSave": true,
+  "editor.formatOnSaveMode": "file", // oxfmt can only format whole files
+  "editor.codeActionsOnSave": {
+    "source.fixAll.oxc": "explicit",
+    "source.organizeImports": "never", // let oxfmt handle import organization
+  },
+}
+```
+
+</details>
+
+### Zed
+
+Zed ships with the oxc language servers built in.
+
+<details>
+<summary>Show Zed config</summary>
+
+`.zed/settings.json`:
+
+```jsonc
+{
+  "lsp": {
+    "oxlint": {
+      "initialization_options": {
+        "settings": {
+          "configPath": null,
+          "run": "onType",
+          "disableNestedConfig": false,
+          "fixKind": "safe_fix",
+          "unusedDisableDirectives": "deny",
+        },
+      },
+    },
+    "oxfmt": {
+      "initialization_options": {
+        "settings": {
+          "fmt.configPath": null,
+          "run": "onSave",
+        },
+      },
+    },
+  },
+  "languages": {
+    "TypeScript": {
+      "format_on_save": "on",
+      "prettier": { "allowed": false },
+      "language_servers": ["...", "oxlint", "oxfmt"],
+      "formatter": [
+        { "language_server": { "name": "oxfmt" } },
+        { "code_action": "source.fixAll.oxc" },
+      ],
+    },
+    "TSX": {
+      "format_on_save": "on",
+      "prettier": { "allowed": false },
+      "language_servers": ["...", "oxlint", "oxfmt"],
+      "formatter": [
+        { "language_server": { "name": "oxfmt" } },
+        { "code_action": "source.fixAll.oxc" },
+      ],
+    },
+    "JavaScript": {
+      "format_on_save": "on",
+      "prettier": { "allowed": false },
+      "language_servers": ["...", "oxlint", "oxfmt"],
+      "formatter": [
+        { "language_server": { "name": "oxfmt" } },
+        { "code_action": "source.fixAll.oxc" },
+      ],
+    },
+    "JSON": {
+      "format_on_save": "on",
+      "prettier": { "allowed": false },
+      "formatter": [{ "language_server": { "name": "oxfmt" } }],
+    },
+    "Markdown": {
+      "format_on_save": "on",
+      "prettier": { "allowed": false },
+      "formatter": [{ "language_server": { "name": "oxfmt" } }],
+    },
+  },
+}
+```
+
+Apply the same `languages` block to any other file types you want oxfmt to
+format (`JSONC`, `CSS`, `HTML`, `YAML`, …).
+
+</details>

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+import { defineConfig } from "oxfmt";
+import { defineConfig as defineConfig$1 } from "oxlint";
+//#region src/index.d.ts
+type OxlintOptions = Parameters<typeof defineConfig$1>[0];
+type OxfmtOptions = Parameters<typeof defineConfig>[0];
+declare const pluginToggles: {
+  typescript: {
+    packages: string[];
+    plugins: "typescript"[];
+  };
+  react: {
+    packages: string[];
+    plugins: ("react" | "jsx-a11y" | "react-perf")[];
+  };
+  vue: {
+    packages: string[];
+    plugins: "vue"[];
+  };
+  next: {
+    packages: string[];
+    plugins: "nextjs"[];
+  };
+  vitest: {
+    packages: string[];
+    plugins: "vitest"[];
+  };
+  jest: {
+    packages: string[];
+    plugins: "jest"[];
+  };
+};
+type ToggleName = keyof typeof pluginToggles;
+interface OxlintConfigOptions extends Partial<Record<ToggleName, boolean>> {
+  /**
+   * Enable `eslint-plugin-better-tailwindcss`. Auto-detected from a `tailwindcss`
+   * dependency; set it explicitly when Tailwind lives in a nested workspace.
+   *
+   * The plugin is an optional peer dependency — install it yourself
+   * (`pnpm add -D eslint-plugin-better-tailwindcss`). If it is missing, a warning
+   * is logged and Tailwind linting is skipped. Point the plugin at your entry
+   * CSS via `override.settings`.
+   */
+  tailwind?: boolean;
+  /**
+   * Deep-merged over the base config via defu.
+   */
+  override?: OxlintOptions;
+  /**
+   * Directory whose `package.json` is scanned to auto-detect plugins.
+   *
+   * @default process.cwd()
+   */
+  cwd?: string;
+}
+interface OxfmtConfigOptions {
+  override?: OxfmtOptions;
+}
+declare function oxlintConfig(options?: OxlintConfigOptions): OxlintOptions;
+declare function oxfmtConfig({ override }?: OxfmtConfigOptions): OxfmtOptions;
+//#endregion
+export { oxfmtConfig, oxlintConfig };

package/dist/index.mjs

@@ -0,0 +1,588 @@
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import process from "node:process";
+import { defu } from "defu";
+import { defineConfig } from "oxfmt";
+import { defineConfig as defineConfig$1 } from "oxlint";
+//#region src/index.ts
+const baseOxlintConfig = defineConfig$1({
+	categories: {
+		correctness: "error",
+		suspicious: "warn",
+		perf: "warn"
+	},
+	env: {
+		builtin: true,
+		es2026: true,
+		browser: true,
+		node: true
+	},
+	globals: {
+		AudioPlaybackStats: "readonly",
+		CSSFontFaceDescriptors: "readonly",
+		CSSPseudoElement: "readonly",
+		LanguageModel: "readonly",
+		ModelContext: "readonly",
+		Sanitizer: "readonly",
+		TimelineTrigger: "readonly",
+		TimelineTriggerRange: "readonly",
+		TimelineTriggerRangeList: "readonly",
+		WebMCPEvent: "readonly",
+		XRCompositionLayer: "readonly",
+		XRCubeLayer: "readonly",
+		XRCylinderLayer: "readonly",
+		XREquirectLayer: "readonly",
+		XRLayerEvent: "readonly",
+		XRPlane: "readonly",
+		XRPlaneSet: "readonly",
+		XRProjectionLayer: "readonly",
+		XRQuadLayer: "readonly",
+		XRSubImage: "readonly",
+		XRWebGLSubImage: "readonly"
+	},
+	ignorePatterns: [
+		"**/.DS_Store",
+		"**/node_modules",
+		"**/.turbo",
+		"**/*.tsbuildinfo",
+		"**/.idea",
+		"**/.node-modules-inspector",
+		"**/.pnpm-store",
+		"**/dist",
+		"**/package-lock.json",
+		"**/yarn.lock",
+		"**/pnpm-lock.yaml",
+		"**/bun.lockb",
+		"**/output",
+		"**/coverage",
+		"**/temp",
+		"**/.temp",
+		"**/tmp",
+		"**/.tmp",
+		"**/.history",
+		"**/.vitepress/cache",
+		"**/.nuxt",
+		"**/.next",
+		"**/.svelte-kit",
+		"**/.vercel",
+		"**/.changeset",
+		"**/.cache",
+		"**/.output",
+		"**/.vite-inspect",
+		"**/.yarn",
+		"**/CHANGELOG*.md",
+		"**/LICENSE*",
+		"**/*.min.*",
+		"**/__snapshots__",
+		"**/vite.config.*.timestamp-*",
+		"**/auto-import?(s).d.ts",
+		"**/components.d.ts",
+		"**/.context",
+		"**/.claude",
+		"**/.agents",
+		"**/.*/skills",
+		"**/*.md",
+		"**/routeTree.gen.ts",
+		"**/release/**/*",
+		"**/.tanstack/**/*",
+		"**/.nitro/**/*",
+		"**/.output/**/*",
+		"**/.source/**/*",
+		"**/dist-electron/**/*",
+		"**/dist-desktop/**/*",
+		"**/playwright-report/**/*",
+		"**/test-results/**/*",
+		"**/.types/**/*",
+		"**/migrations/**/*",
+		"**/migrations.json"
+	],
+	rules: {
+		"accessor-pairs": ["error", {
+			enforceForClassMembers: true,
+			setWithoutGet: true
+		}],
+		"array-callback-return": "error",
+		"block-scoped-var": "error",
+		"constructor-super": "error",
+		"default-case-last": "error",
+		"eqeqeq": ["error", "smart"],
+		"new-cap": ["error", {
+			capIsNew: false,
+			newIsCap: true,
+			properties: true
+		}],
+		"no-alert": "error",
+		"no-array-constructor": "error",
+		"no-async-promise-executor": "error",
+		"no-caller": "error",
+		"no-case-declarations": "error",
+		"no-class-assign": "error",
+		"no-compare-neg-zero": "error",
+		"no-cond-assign": ["error", "always"],
+		"no-console": ["warn", { allow: ["warn", "error"] }],
+		"no-const-assign": "error",
+		"no-control-regex": "error",
+		"no-debugger": "error",
+		"no-delete-var": "error",
+		"no-dupe-class-members": "error",
+		"no-dupe-keys": "error",
+		"no-duplicate-case": "error",
+		"no-empty": ["error", { allowEmptyCatch: true }],
+		"no-empty-pattern": "error",
+		"no-eval": "error",
+		"no-ex-assign": "error",
+		"no-extend-native": "error",
+		"no-extra-bind": "error",
+		"no-extra-boolean-cast": "error",
+		"no-fallthrough": "error",
+		"no-func-assign": "error",
+		"no-global-assign": "error",
+		"no-implied-eval": "error",
+		"no-import-assign": "error",
+		"no-irregular-whitespace": "error",
+		"no-iterator": "error",
+		"no-labels": ["error", {
+			allowLoop: false,
+			allowSwitch: false
+		}],
+		"no-lone-blocks": "error",
+		"no-loss-of-precision": "error",
+		"no-misleading-character-class": "error",
+		"no-multi-str": "error",
+		"no-new": "error",
+		"no-new-func": "error",
+		"no-new-native-nonconstructor": "error",
+		"no-new-wrappers": "error",
+		"no-obj-calls": "error",
+		"no-proto": "error",
+		"no-prototype-builtins": "error",
+		"no-redeclare": ["error", { builtinGlobals: false }],
+		"no-regex-spaces": "error",
+		"no-restricted-globals": [
+			"error",
+			{
+				message: "Use `globalThis` instead.",
+				name: "global"
+			},
+			{
+				message: "Use `globalThis` instead.",
+				name: "self"
+			}
+		],
+		"no-restricted-properties": [
+			"error",
+			{
+				message: "Use `Object.getPrototypeOf` or `Object.setPrototypeOf` instead.",
+				property: "__proto__"
+			},
+			{
+				message: "Use `Object.defineProperty` instead.",
+				property: "__defineGetter__"
+			},
+			{
+				message: "Use `Object.defineProperty` instead.",
+				property: "__defineSetter__"
+			},
+			{
+				message: "Use `Object.getOwnPropertyDescriptor` instead.",
+				property: "__lookupGetter__"
+			},
+			{
+				message: "Use `Object.getOwnPropertyDescriptor` instead.",
+				property: "__lookupSetter__"
+			}
+		],
+		"no-self-assign": ["error", { props: true }],
+		"no-self-compare": "error",
+		"no-sequences": "error",
+		"no-shadow": "off",
+		"no-shadow-restricted-names": "error",
+		"no-sparse-arrays": "error",
+		"no-template-curly-in-string": "error",
+		"no-this-before-super": "error",
+		"no-throw-literal": "error",
+		"no-underscore-dangle": ["warn", { allow: [
+			"__filename",
+			"__dirname",
+			"_url",
+			"_URL"
+		] }],
+		"no-unexpected-multiline": "error",
+		"no-unmodified-loop-condition": "error",
+		"no-unneeded-ternary": ["error", { defaultAssignment: false }],
+		"no-unreachable": "error",
+		"no-unsafe-finally": "error",
+		"no-unsafe-negation": "error",
+		"no-unused-expressions": ["error", {
+			allowShortCircuit: true,
+			allowTaggedTemplates: true,
+			allowTernary: true
+		}],
+		"no-unused-vars": ["error", {
+			args: "none",
+			argsIgnorePattern: "^_",
+			caughtErrors: "none",
+			ignoreRestSiblings: true,
+			vars: "all",
+			varsIgnorePattern: "^_"
+		}],
+		"no-use-before-define": ["error", {
+			classes: false,
+			functions: false,
+			variables: true
+		}],
+		"no-useless-call": "error",
+		"no-useless-catch": "error",
+		"no-useless-computed-key": "error",
+		"no-useless-constructor": "error",
+		"no-useless-rename": "error",
+		"no-useless-return": "error",
+		"no-var": "error",
+		"no-with": "error",
+		"object-shorthand": [
+			"error",
+			"always",
+			{
+				avoidQuotes: true,
+				ignoreConstructors: false
+			}
+		],
+		"prefer-const": ["error", {
+			destructuring: "all",
+			ignoreReadBeforeAssign: true
+		}],
+		"prefer-exponentiation-operator": "error",
+		"prefer-promise-reject-errors": "error",
+		"prefer-regex-literals": ["error", { disallowRedundantWrapping: true }],
+		"prefer-rest-params": "error",
+		"prefer-spread": "error",
+		"prefer-template": "error",
+		"symbol-description": "error",
+		"unicode-bom": ["error", "never"],
+		"use-isnan": ["error", {
+			enforceForIndexOf: true,
+			enforceForSwitchCase: true
+		}],
+		"valid-typeof": ["error", { requireStringLiterals: true }],
+		"vars-on-top": "error",
+		"yoda": ["error", "never"],
+		"import/consistent-type-specifier-style": ["error", "prefer-top-level"],
+		"import/first": "error",
+		"import/no-duplicates": "error",
+		"import/no-mutable-exports": "error",
+		"import/no-named-default": "error",
+		"import/no-unassigned-import": "off",
+		"import/newline-after-import": ["error", { count: 1 }],
+		"no-unassigned-vars": "warn",
+		"preserve-caught-error": "warn",
+		"react/react-in-jsx-scope": "off",
+		"jsx-a11y/anchor-has-content": "warn",
+		"jsx-a11y/click-events-have-key-events": "warn",
+		"jsx-a11y/control-has-associated-label": "warn",
+		"jsx-a11y/interactive-supports-focus": "warn",
+		"jsx-a11y/label-has-associated-control": "warn",
+		"jsx-a11y/mouse-events-have-key-events": "warn",
+		"jsx-a11y/no-autofocus": "off",
+		"jsx-a11y/no-noninteractive-element-interactions": "warn",
+		"jsx-a11y/no-noninteractive-tabindex": "warn",
+		"jsx-a11y/no-redundant-roles": "warn",
+		"jsx-a11y/no-static-element-interactions": "warn",
+		"jsx-a11y/prefer-tag-over-role": "warn",
+		"react/rules-of-hooks": "error",
+		"react/exhaustive-deps": ["warn", { additionalHooks: "(useMountedEffect)" }],
+		"typescript/no-explicit-any": "error"
+	},
+	overrides: [
+		{
+			files: ["**/*.?([cm])[jt]s?(x)"],
+			rules: {
+				"node/handle-callback-err": ["error", "^(err|error)$"],
+				"node/no-exports-assign": "error",
+				"node/no-new-require": "error",
+				"node/no-path-concat": "error",
+				"jsdoc/check-access": "warn",
+				"jsdoc/check-property-names": "warn",
+				"jsdoc/empty-tags": "warn",
+				"jsdoc/implements-on-classes": "warn",
+				"jsdoc/no-defaults": "warn",
+				"jsdoc/require-param-name": "warn",
+				"jsdoc/require-property": "warn",
+				"jsdoc/require-property-description": "warn",
+				"jsdoc/require-property-name": "warn",
+				"jsdoc/require-returns-description": "warn",
+				"unicorn/consistent-empty-array-spread": "error",
+				"unicorn/error-message": "error",
+				"unicorn/escape-case": "error",
+				"unicorn/new-for-builtins": "error",
+				"unicorn/no-instanceof-builtins": "error",
+				"unicorn/no-new-array": "error",
+				"unicorn/no-new-buffer": "error",
+				"unicorn/number-literal-case": "error",
+				"unicorn/prefer-dom-node-text-content": "error",
+				"unicorn/prefer-includes": "error",
+				"unicorn/prefer-node-protocol": "error",
+				"unicorn/prefer-number-properties": "error",
+				"unicorn/prefer-string-starts-ends-with": "error",
+				"unicorn/prefer-type-error": "error",
+				"unicorn/throw-new-error": "error"
+			},
+			plugins: [
+				"node",
+				"jsdoc",
+				"unicorn"
+			]
+		},
+		{
+			files: ["**/*.?([cm])ts", "**/*.?([cm])tsx"],
+			rules: {
+				"constructor-super": "off",
+				"getter-return": "off",
+				"no-class-assign": "off",
+				"no-const-assign": "off",
+				"no-dupe-keys": "off",
+				"no-func-assign": "off",
+				"no-import-assign": "off",
+				"no-new-native-nonconstructor": "off",
+				"no-obj-calls": "off",
+				"no-redeclare": ["error", { builtinGlobals: false }],
+				"no-setter-return": "off",
+				"no-this-before-super": "off",
+				"no-unreachable": "off",
+				"no-unsafe-negation": "off",
+				"no-with": "off",
+				"prefer-const": ["error", {
+					destructuring: "all",
+					ignoreReadBeforeAssign: true
+				}],
+				"no-unused-expressions": ["error", {
+					allowShortCircuit: true,
+					allowTaggedTemplates: true,
+					allowTernary: true
+				}],
+				"no-unused-vars": "off",
+				"no-useless-constructor": "off",
+				"no-use-before-define": ["error", {
+					classes: false,
+					functions: false,
+					variables: true
+				}],
+				"typescript/ban-ts-comment": ["error", { "ts-expect-error": "allow-with-description" }],
+				"typescript/no-duplicate-enum-values": "error",
+				"typescript/no-dynamic-delete": "off",
+				"typescript/no-empty-object-type": ["error", { allowInterfaces: "always" }],
+				"typescript/no-extra-non-null-assertion": "error",
+				"typescript/no-extraneous-class": "off",
+				"typescript/no-invalid-void-type": "off",
+				"typescript/no-misused-new": "error",
+				"typescript/no-namespace": "error",
+				"typescript/no-non-null-asserted-nullish-coalescing": "error",
+				"typescript/no-non-null-asserted-optional-chain": "error",
+				"typescript/no-non-null-assertion": "off",
+				"typescript/no-require-imports": "error",
+				"typescript/no-this-alias": "error",
+				"typescript/no-unnecessary-type-constraint": "error",
+				"typescript/no-unsafe-declaration-merging": "error",
+				"typescript/no-unsafe-function-type": "error",
+				"typescript/no-wrapper-object-types": "error",
+				"typescript/prefer-as-const": "error",
+				"typescript/prefer-literal-enum-member": "error",
+				"typescript/prefer-namespace-keyword": "error",
+				"typescript/triple-slash-reference": "off",
+				"typescript/unified-signatures": "off",
+				"typescript/consistent-type-definitions": ["error", "interface"],
+				"typescript/consistent-type-imports": ["error", {
+					disallowTypeAnnotations: false,
+					fixStyle: "separate-type-imports",
+					prefer: "type-imports"
+				}],
+				"typescript/method-signature-style": ["error", "property"],
+				"typescript/no-import-type-side-effects": "error"
+			}
+		},
+		{
+			files: [
+				"**/__tests__/**/*.?([cm])[jt]s?(x)",
+				"**/*.spec.?([cm])[jt]s?(x)",
+				"**/*.test.?([cm])[jt]s?(x)",
+				"**/*.bench.?([cm])[jt]s?(x)",
+				"**/*.benchmark.?([cm])[jt]s?(x)"
+			],
+			rules: {
+				"vitest/consistent-test-it": ["error", {
+					fn: "it",
+					withinDescribe: "it"
+				}],
+				"vitest/no-identical-title": "error",
+				"vitest/no-import-node-test": "error",
+				"vitest/prefer-hooks-in-order": "error",
+				"vitest/prefer-lowercase-title": "error",
+				"no-unused-expressions": "off",
+				"typescript/explicit-function-return-type": "off"
+			},
+			plugins: ["vitest"]
+		},
+		{
+			files: ["**/*.?([cm])[jt]s?(x)"],
+			rules: {
+				"react/no-array-index-key": "warn",
+				"react/no-clone-element": "warn",
+				"react/no-direct-mutation-state": "error",
+				"react/jsx-no-comment-textnodes": "warn",
+				"react/only-export-components": ["error", {
+					allowConstantExport: false,
+					allowExportNames: []
+				}]
+			}
+		},
+		{
+			files: ["**/*.md/**/*.?([cm])[jt]s?(x)"],
+			rules: {
+				"no-alert": "off",
+				"no-labels": "off",
+				"no-lone-blocks": "off",
+				"no-unused-expressions": "off",
+				"no-unused-labels": "off",
+				"no-unused-vars": "off",
+				"unicode-bom": "off",
+				"no-redeclare": "off",
+				"no-use-before-define": "off",
+				"typescript/consistent-type-imports": "off",
+				"typescript/explicit-function-return-type": "off",
+				"typescript/no-namespace": "off",
+				"typescript/no-require-imports": "off"
+			}
+		},
+		{
+			files: ["**/scripts/**/*.?([cm])[jt]s?(x)"],
+			rules: { "typescript/explicit-function-return-type": "off" }
+		},
+		{
+			files: ["**/*.js", "**/*.cjs"],
+			rules: { "typescript/no-require-imports": "off" }
+		},
+		{
+			files: ["**/*.config.?([cm])[jt]s?(x)", "**/*.config.*.?([cm])[jt]s?(x)"],
+			rules: { "typescript/explicit-function-return-type": "off" }
+		},
+		{
+			files: ["**/e2e/**/*"],
+			rules: { "react/rules-of-hooks": "off" }
+		},
+		{
+			files: ["**/monaco-worker.ts"],
+			rules: { "import/default": "off" }
+		}
+	]
+});
+const baseOxfmtConfig = defineConfig({
+	singleQuote: true,
+	semi: false,
+	arrowParens: "avoid",
+	sortImports: true,
+	quoteProps: "consistent"
+});
+const basePlugins = [
+	"import",
+	"unicorn",
+	"jsdoc",
+	"node",
+	"promise",
+	"oxc"
+];
+const pluginToggles = {
+	typescript: {
+		packages: ["typescript"],
+		plugins: ["typescript"]
+	},
+	react: {
+		packages: ["react"],
+		plugins: [
+			"react",
+			"jsx-a11y",
+			"react-perf"
+		]
+	},
+	vue: {
+		packages: ["vue"],
+		plugins: ["vue"]
+	},
+	next: {
+		packages: ["next"],
+		plugins: ["nextjs"]
+	},
+	vitest: {
+		packages: ["vitest"],
+		plugins: ["vitest"]
+	},
+	jest: {
+		packages: ["jest"],
+		plugins: ["jest"]
+	}
+};
+const tailwindConfig = defineConfig$1({ jsPlugins: ["eslint-plugin-better-tailwindcss"] });
+function getInstalledPackages(cwd) {
+	const names = /* @__PURE__ */ new Set();
+	try {
+		const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf-8"));
+		for (const field of [
+			pkg.dependencies,
+			pkg.devDependencies,
+			pkg.peerDependencies
+		]) for (const name of Object.keys(field ?? {})) names.add(name);
+	} catch {}
+	return names;
+}
+function resolvePlugins(options, installed) {
+	const plugins = [...basePlugins];
+	for (const name of Object.keys(pluginToggles)) {
+		const toggle = pluginToggles[name];
+		if (options[name] ?? toggle.packages.some((pkg) => installed.has(pkg))) plugins.push(...toggle.plugins);
+	}
+	return [...new Set(plugins)];
+}
+/**
+* Build an oxlint config.
+*
+* Framework plugins (`typescript`, `react`, `vue`, `next`, `vitest`, `jest`,
+* `tailwind`) are auto-enabled by detecting their package in the nearest
+* `package.json`. If a dependency is not found there — e.g. it lives in a nested
+* workspace like `apps/web/package.json` — its plugin stays off, so enable it
+* manually:
+*
+* @example
+* ```ts
+* // auto-detect from the current package.json
+* export default oxlintConfig()
+* ```
+* @example
+* ```ts
+* // dep lives in a nested workspace — turn the plugin on by hand
+* export default oxlintConfig({ vue: true })
+* ```
+* @example
+* ```ts
+* // Tailwind, pointed at the entry CSS so classes can be resolved
+* export default oxlintConfig({
+*   tailwind: true,
+*   override: {
+*     settings: { 'better-tailwindcss': { entryPoint: 'src/styles/globals.css' } },
+*   },
+* })
+* ```
+*/
+const TAILWIND_PLUGIN = "eslint-plugin-better-tailwindcss";
+function oxlintConfig(options = {}) {
+	const { override = {} } = options;
+	const installed = getInstalledPackages(options.cwd ?? process.cwd());
+	let tailwind = options.tailwind ?? installed.has("tailwindcss");
+	if (tailwind && !installed.has(TAILWIND_PLUGIN)) {
+		console.warn(`[@letstri/oxc-config] Tailwind linting needs "${TAILWIND_PLUGIN}". Install it: pnpm add -D ${TAILWIND_PLUGIN}`);
+		tailwind = false;
+	}
+	return defu(override, { plugins: resolvePlugins(options, installed) }, tailwind ? tailwindConfig : {}, baseOxlintConfig);
+}
+function oxfmtConfig({ override = {} } = {}) {
+	return defu(override, baseOxfmtConfig);
+}
+//#endregion
+export { oxfmtConfig, oxlintConfig };

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@letstri/oxc-config",
+  "version": "0.1.0",
+  "description": "Opinionated Oxlint and Oxfmt configs",
+  "homepage": "https://github.com/letstri/oxc-config#readme",
+  "bugs": {
+    "url": "https://github.com/letstri/oxc-config/issues"
+  },
+  "license": "MIT",
+  "author": "Valerii Strilets",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/letstri/oxc-config.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "check-types": "tsc --noEmit",
+    "lint": "oxlint -c oxlint.config.ts",
+    "lint:fix": "oxlint -c oxlint.config.ts --fix",
+    "format": "oxfmt -c oxfmt.config.ts",
+    "format:check": "oxfmt -c oxfmt.config.ts --check",
+    "check": "run-p lint check-types format:check",
+    "update": "taze -r -I major",
+    "prepare": "husky",
+    "prepublishOnly": "pnpm run build"
+  },
+  "dependencies": {
+    "defu": "^6.1.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "husky": "^9.1.7",
+    "npm-run-all2": "^9.0.2",
+    "oxfmt": "^0.58.0",
+    "oxlint": "^1.73.0",
+    "taze": "^19.14.1",
+    "tsdown": "^0.22.4",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "eslint-plugin-better-tailwindcss": ">=4",
+    "oxfmt": ">=0.58.0",
+    "oxlint": ">=1.73.0"
+  },
+  "peerDependenciesMeta": {
+    "eslint-plugin-better-tailwindcss": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "packageManager": "pnpm@11.11.0"
+}