@santux/oxc-config 0.0.0 → 1.0.0

package/README.md

@@ -1,45 +1,97 @@
 # @santux/oxc-config
 
-## ⚠️ IMPORTANT NOTICE ⚠️
+Shared oxlint, oxfmt and commitlint config for TypeScript projects. It follows the opinions of [`@santux/eslint-config`](../eslint-config) with native oxlint rules, plus JS plugins for the few rules oxlint has no native version of.
 
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
+## Entries
 
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
+| Entry                                | Tool       | Export        |
+| ------------------------------------ | ---------- | ------------- |
+| `@santux/oxc-config/lint`            | oxlint     | Config object |
+| `@santux/oxc-config/next`            | oxlint     | Config object |
+| `@santux/oxc-config/react-vite`      | oxlint     | Config object |
+| `@santux/oxc-config/tanstack-start`  | oxlint     | Config object |
+| `@santux/oxc-config/astro`           | oxlint     | Config object |
+| `@santux/oxc-config/astro-react`     | oxlint     | Config object |
+| `@santux/oxc-config/tailwind`        | oxlint     | Config object |
+| `@santux/oxc-config/format`          | oxfmt      | Config object |
+| `@santux/oxc-config/format-next`     | oxfmt      | Config object |
+| `@santux/oxc-config/format-astro`    | oxfmt      | Config object |
+| `@santux/oxc-config/format-tailwind` | oxfmt      | Config object |
+| `@santux/oxc-config/commitlint`      | commitlint | Config object |
 
-## Purpose
+The lint entry enables type-aware rules (`options.typeAware`, run by `oxlint-tsgolint`) with the equivalents of typescript-eslint `strictTypeChecked` + `stylisticTypeChecked`, plus `import`, unicorn and `unicorn/filename-case` (kebab-case). Type-aware rules are off in `.js`, `.cjs` and `.mjs` files, as with typescript-eslint `disableTypeChecked`.
 
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@santux/oxc-config`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
+Rules oxlint has no native version of run as [JS plugins](https://oxc.rs/docs/guide/usage/linter/js-plugins.html), which oxlint marks as alpha. Only rules that need no type information are used:
 
-## What is OIDC Trusted Publishing?
+| Rule id                                                    | Source                                          |
+| ---------------------------------------------------------- | ----------------------------------------------- |
+| `check-file/folder-naming-convention`                      | `eslint-plugin-check-file`                      |
+| `react-js/jsx-sort-props`, `react-js/jsx-no-leaked-render` | `eslint-plugin-react`, in the Framework entries |
+| `@stylistic/padding-line-between-statements`               | `@stylistic/eslint-plugin`                      |
+| `shadcn/*`                                                 | `@shadcn/lint`, in the `tailwind` entry         |
 
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
+The `next`, `react-vite` and `tanstack-start` entries build on the lint entry with react, react-hooks and jsx-a11y rules (`react.version` is `19`). `next` adds the Next.js rules and allows App Router folder names, `react-vite` adds `react/only-export-components`, and `tanstack-start` turns off the file and folder name rules under `routes`. Compose them after the base: `defineConfig({ extends: [santux, next] })`. They need `eslint-plugin-react`, an optional peer dependency.
 
-## Setup Instructions
+The `astro` entry adds browser and Node globals and turns off the file and folder name rules under `pages`, plus the file name rule for `.astro` components. oxlint only lints the script blocks of `.astro` files (the frontmatter and `<script>` tags), without type-aware rules, and has no Astro rules or template checks. Set `**/.astro/**` in your own `ignorePatterns`.
 
-To properly configure OIDC trusted publishing for this package:
+The `astro-react` entry adds the React rules of the Framework entries to the `.jsx` and `.tsx` files of an Astro project with React islands (`@astrojs/react`), without `only-export-components`. Compose it after the `astro` entry: `defineConfig({ extends: [santux, astro, astroReact] })`. It needs `eslint-plugin-react`.
 
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
+The `tailwind` entry adds [`@shadcn/lint`](https://github.com/shadcn-ui/lint) (an optional peer dependency) with every rule except `require-static-classes`: `no-unknown-classes`, `no-raw-colors`, `no-arbitrary-values`, `no-inline-styles` and `no-restyle`. It needs no shadcn/ui: it finds the stylesheet that imports Tailwind, and it reads `components.json` when there is one. `no-restyle` only knows your design system components through `components.json` or `settings.shadcn.componentImports`.
 
-## DO NOT USE THIS PACKAGE
+The entries set no `ignorePatterns`, because oxlint does not inherit them through `extends`. oxlint already skips what `.gitignore` lists; set `ignorePatterns` in your own `oxlint.config.ts` for anything else.
 
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
+oxfmt has no `extends`, so the format entries are plain objects that you import and spread. The `format` entry uses the same Prettier options as the `eslint` package, with `endOfLine: 'lf'` (oxfmt doesn't support `auto`), and sorts imports to reproduce the `eslint` import order: `type`, `react`, `builtin`, `external`, `internal`, `alias` (`@/**`), `parent`, `sibling`, `index`, with a blank line between groups, case-insensitive ascending order, and side-effect imports sorted too. Outside Next.js the `react` group is `react`, `react-dom` and `react-dom/**`. In a Next.js project spread `format-next` after `format` to add `next` and `next/**` to that group. The `format-tailwind` entry enables oxfmt Tailwind class sorting, so no plugin is needed. The `format-astro` entry turns on `.astro` formatting, which oxfmt leaves off by default. It needs `@astrojs/compiler-rs`, an optional peer dependency that oxfmt does not bundle.
 
-## More Information
+## Usage
 
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
+Every tool is an exact-version peer dependency and must be installed in your project:
 
----
+```sh
+pnpm add -D @santux/oxc-config @commitlint/cli @commitlint/config-conventional @stylistic/eslint-plugin eslint-plugin-check-file husky oxfmt oxlint oxlint-tsgolint
+```
 
-**Maintained for OIDC setup purposes only**
+```ts
+// oxlint.config.ts
+import santux from '@santux/oxc-config/lint'
+import next from '@santux/oxc-config/next'
+import { defineConfig } from 'oxlint'
+
+export default defineConfig({
+  extends: [santux, next],
+  // Override, disable or add rules locally
+  rules: { 'no-console': 'off' },
+})
+```
+
+```ts
+// oxfmt.config.ts
+import santux from '@santux/oxc-config/format'
+import formatNext from '@santux/oxc-config/format-next'
+import formatTailwind from '@santux/oxc-config/format-tailwind'
+import { defineConfig } from 'oxfmt'
+
+export default defineConfig({ ...santux, ...formatNext, ...formatTailwind, printWidth: 120 })
+```
+
+```js
+// commitlint.config.js
+export { default } from '@santux/oxc-config/commitlint'
+```
+
+Requires Node `>=22.18`, which oxlint needs to auto-discover TypeScript config files.
+
+## Differences from `@santux/eslint-config`
+
+The `eslint` package is the reference. The differences left are:
+
+- File names are checked with `unicorn/filename-case` instead of check-file.
+- react-hooks `config` and `gating` are dropped. They validate React Compiler options, not your code.
+- `import/no-extraneous-dependencies` and `import/no-useless-path-segments` are dropped. oxlint has no native version, and `eslint-plugin-import-x` loads ESLint at runtime.
+
+`import/order` is replaced by oxfmt import sorting. ESLint's `import/order` does not move imports across side-effect imports, while oxfmt with side-effect sorting does, so files with CSS or `server-only` imports can end up ordered differently between the two packages.
+
+`import/no-cycle` was verified on a sample project: it detects cycles through `.ts` files and `@/` imports, so it stays enabled.
+
+## Versioning
+
+This package follows strict semver: **any change that can make previously passing code fail is a major release**. That includes a new error-level rule, a rule moving from warning to error, and a newer required tool or Node version. Projects can stay on an older major for as long as they want.

package/package.json

@@ -1,10 +1,127 @@
 {
   "name": "@santux/oxc-config",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @santux/oxc-config",
+  "version": "1.0.0",
+  "description": "Shared oxlint, oxfmt and commitlint config for TypeScript projects.",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "commitlint",
+    "oxc",
+    "oxfmt",
+    "oxlint"
+  ],
+  "license": "ISC",
+  "author": {
+    "name": "Nicolás Santuccio",
+    "email": "nico.santuccio@gmail.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nicosantux/santux.git",
+    "directory": "packages/oxc-config"
+  },
+  "files": [
+    "src",
+    "!src/test",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    "./lint": {
+      "types": "./src/lint.d.ts",
+      "default": "./src/lint.js"
+    },
+    "./format": {
+      "types": "./src/format.d.ts",
+      "default": "./src/format.js"
+    },
+    "./format-astro": {
+      "types": "./src/format-astro.d.ts",
+      "default": "./src/format-astro.js"
+    },
+    "./format-next": {
+      "types": "./src/format-next.d.ts",
+      "default": "./src/format-next.js"
+    },
+    "./format-tailwind": {
+      "types": "./src/format-tailwind.d.ts",
+      "default": "./src/format-tailwind.js"
+    },
+    "./commitlint": {
+      "types": "./src/commitlint.d.ts",
+      "default": "./src/commitlint.js"
+    },
+    "./astro": {
+      "types": "./src/astro.d.ts",
+      "default": "./src/astro.js"
+    },
+    "./astro-react": {
+      "types": "./src/astro-react.d.ts",
+      "default": "./src/astro-react.js"
+    },
+    "./next": {
+      "types": "./src/next.d.ts",
+      "default": "./src/next.js"
+    },
+    "./react-vite": {
+      "types": "./src/react-vite.d.ts",
+      "default": "./src/react-vite.js"
+    },
+    "./tanstack-start": {
+      "types": "./src/tanstack-start.d.ts",
+      "default": "./src/tanstack-start.js"
+    },
+    "./tailwind": {
+      "types": "./src/tailwind.d.ts",
+      "default": "./src/tailwind.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@astrojs/compiler-rs": "0.5.3",
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@shadcn/lint": "0.2.5",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "eslint-plugin-check-file": "3.3.2",
+    "eslint-plugin-react": "7.37.5",
+    "husky": "9.1.7",
+    "oxfmt": "0.78.0",
+    "oxlint": "1.93.0",
+    "oxlint-tsgolint": "7.0.2007",
+    "tailwindcss": "4.3.5",
+    "typescript": "6.0.3",
+    "vitest": "5.1.0"
+  },
+  "peerDependencies": {
+    "@astrojs/compiler-rs": "0.5.3",
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@shadcn/lint": "0.2.5",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "eslint-plugin-check-file": "3.3.2",
+    "eslint-plugin-react": "7.37.5",
+    "husky": "9.1.7",
+    "oxfmt": "0.78.0",
+    "oxlint": "1.93.0",
+    "oxlint-tsgolint": "7.0.2007"
+  },
+  "peerDependenciesMeta": {
+    "@astrojs/compiler-rs": {
+      "optional": true
+    },
+    "@shadcn/lint": {
+      "optional": true
+    },
+    "eslint-plugin-react": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.18"
+  }
 }

package/src/astro-react.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/astro-react.js

@@ -0,0 +1,7 @@
+import { reactConfig } from './react.js'
+
+// oxlint `overrides` do not accept `settings`
+const { settings, ...config } = reactConfig({ env: { browser: true } })
+
+/** @type {import('oxlint').OxlintConfig} */
+export default { settings, overrides: [{ files: ['**/*.{jsx,tsx}'], ...config }] }

package/src/astro.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/astro.js

@@ -0,0 +1,12 @@
+/** @type {import('oxlint').OxlintConfig} */
+export default {
+  env: { browser: true, node: true },
+  overrides: [
+    {
+      files: ['**/pages/**'],
+      rules: { 'check-file/folder-naming-convention': 'off', 'unicorn/filename-case': 'off' },
+    },
+    // Astro components are PascalCase, and the eslint package does not check .astro file names
+    { files: ['**/*.astro'], rules: { 'unicorn/filename-case': 'off' } },
+  ],
+}

package/src/commitlint.d.ts

@@ -0,0 +1,2 @@
+declare const config: { extends: string[]; rules: Record<string, [number, string, unknown]> }
+export default config

package/src/commitlint.js

@@ -0,0 +1,8 @@
+/** @type {import('@commitlint/types').UserConfig} */
+export default {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'subject-case': [2, 'always', 'lower-case'],
+    'body-max-line-length': [2, 'always', 72],
+  },
+}

package/src/format-astro.d.ts

@@ -0,0 +1,4 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+declare const config: OxfmtConfig
+export default config

package/src/format-astro.js

@@ -0,0 +1,4 @@
+/** @type {import('oxfmt').OxfmtConfig} */
+export default {
+  astro: true,
+}

package/src/format-next.d.ts

@@ -0,0 +1,4 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+declare const config: OxfmtConfig
+export default config

package/src/format-next.js

@@ -0,0 +1,6 @@
+import { importSorting } from './import-sorting.js'
+
+/** @type {import('oxfmt').OxfmtConfig} */
+export default {
+  sortImports: importSorting(['next', 'next/**', 'react', 'react-dom', 'react-dom/**']),
+}

package/src/format-tailwind.d.ts

@@ -0,0 +1,4 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+declare const config: OxfmtConfig
+export default config

package/src/format-tailwind.js

@@ -0,0 +1,4 @@
+/** @type {import('oxfmt').OxfmtConfig} */
+export default {
+  sortTailwindcss: true,
+}

package/src/format.d.ts

@@ -0,0 +1,4 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+declare const config: OxfmtConfig
+export default config

package/src/format.js

@@ -0,0 +1,18 @@
+import { importSorting } from './import-sorting.js'
+
+/** @type {import('oxfmt').OxfmtConfig} */
+export default {
+  arrowParens: 'always',
+  bracketSameLine: false,
+  bracketSpacing: true,
+  endOfLine: 'lf',
+  jsxSingleQuote: true,
+  printWidth: 100,
+  quoteProps: 'as-needed',
+  semi: false,
+  singleQuote: true,
+  sortImports: importSorting(['react', 'react-dom', 'react-dom/**']),
+  tabWidth: 2,
+  trailingComma: 'all',
+  useTabs: false,
+}

package/src/import-sorting.d.ts

@@ -0,0 +1,5 @@
+import type { OxfmtConfig } from 'oxfmt'
+
+export declare function importSorting(
+  reactPackages: string[],
+): NonNullable<OxfmtConfig['sortImports']>

package/src/import-sorting.js

@@ -0,0 +1,25 @@
+/** oxfmt `sortImports` options. Packages in `reactPackages` are grouped before the other builtins. */
+export function importSorting(reactPackages) {
+  return {
+    customGroups: [
+      { groupName: 'react', modifiers: ['value'], elementNamePattern: reactPackages },
+      { groupName: 'alias', modifiers: ['value'], elementNamePattern: ['@/**'] },
+    ],
+    groups: [
+      'type',
+      'react',
+      'builtin',
+      'external',
+      'internal',
+      'alias',
+      'parent',
+      'sibling',
+      'index',
+      'unknown',
+    ],
+    ignoreCase: true,
+    newlinesBetween: true,
+    order: 'asc',
+    sortSideEffects: true,
+  }
+}

package/src/js-plugins.js

@@ -0,0 +1,10 @@
+import { fileURLToPath } from 'node:url'
+
+/**
+ * An oxlint `jsPlugins` item resolved from this package, so the plugin loads from wherever the
+ * package manager installed this package's peers.
+ */
+export const jsPlugin = (name, specifier) => ({
+  name,
+  specifier: fileURLToPath(import.meta.resolve(specifier)),
+})

package/src/lint.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/lint.js

@@ -0,0 +1,238 @@
+import { jsPlugin } from './js-plugins.js'
+
+/** @type {import('oxlint').OxlintConfig} */
+export default {
+  plugins: ['import', 'oxc', 'typescript', 'unicorn'],
+  jsPlugins: [
+    jsPlugin('check-file', 'eslint-plugin-check-file'),
+    jsPlugin('@stylistic', '@stylistic/eslint-plugin'),
+  ],
+  categories: { correctness: 'error' },
+  options: { typeAware: true },
+  rules: {
+    // Vanilla
+    eqeqeq: ['error', 'always', { null: 'ignore' }],
+    'no-await-in-loop': 'error',
+    'no-case-declarations': 'error',
+    'no-console': 'error',
+    'no-else-return': 'warn',
+    'no-empty': 'error',
+    'no-fallthrough': 'error',
+    'no-implicit-coercion': 'error',
+    'no-param-reassign': 'error',
+    'no-prototype-builtins': 'error',
+    'no-regex-spaces': 'error',
+    'no-self-compare': 'error',
+    'no-unneeded-ternary': 'error',
+    'no-var': 'error',
+    'object-shorthand': 'warn',
+    'prefer-const': 'warn',
+    'prefer-object-spread': 'warn',
+    'prefer-rest-params': 'error',
+    'prefer-spread': 'error',
+    'prefer-template': 'warn',
+    // File naming
+    'unicorn/filename-case': ['error', { case: 'kebabCase' }],
+    'check-file/folder-naming-convention': ['error', { '**/src/**/': 'KEBAB_CASE' }],
+    // Imports
+    'import/first': 'error',
+    'import/newline-after-import': 'warn',
+    'import/no-duplicates': ['warn', { preferInline: true }],
+    'import/no-cycle': 'error',
+    'import/no-mutable-exports': 'error',
+    'import/no-self-import': 'error',
+    // Stylistic
+    '@stylistic/padding-line-between-statements': [
+      'warn',
+      { blankLine: 'always', prev: 'directive', next: '*' },
+      { blankLine: 'always', prev: '*', next: 'block-like' },
+      { blankLine: 'always', prev: 'block-like', next: '*' },
+      { blankLine: 'always', prev: '*', next: 'return' },
+      { blankLine: 'always', prev: ['const', 'let', 'var'], next: '*' },
+      {
+        blankLine: 'any',
+        prev: ['singleline-const', 'singleline-let', 'singleline-var'],
+        next: ['singleline-const', 'singleline-let', 'singleline-var'],
+      },
+    ],
+    // typescript-eslint strictTypeChecked + stylisticTypeChecked
+    'typescript/adjacent-overload-signatures': 'error',
+    'typescript/array-type': 'error',
+    'typescript/await-thenable': 'error',
+    'typescript/ban-ts-comment': 'error',
+    'typescript/ban-tslint-comment': 'error',
+    'typescript/class-literal-property-style': 'error',
+    'typescript/consistent-generic-constructors': 'error',
+    'typescript/consistent-indexed-object-style': 'error',
+    'typescript/consistent-type-assertions': 'error',
+    'typescript/consistent-type-definitions': 'error',
+    'typescript/consistent-type-exports': 'warn',
+    'typescript/consistent-type-imports': ['warn', { fixStyle: 'inline-type-imports' }],
+    'typescript/dot-notation': 'error',
+    'typescript/method-signature-style': 'warn',
+    'typescript/no-array-delete': 'error',
+    'typescript/no-base-to-string': 'error',
+    'typescript/no-confusing-non-null-assertion': 'error',
+    'typescript/no-confusing-void-expression': ['error', { ignoreArrowShorthand: true }],
+    'typescript/no-deprecated': 'error',
+    'typescript/no-duplicate-enum-values': 'error',
+    'typescript/no-duplicate-type-constituents': 'error',
+    'typescript/no-dynamic-delete': 'error',
+    'typescript/no-empty-object-type': 'error',
+    'typescript/no-explicit-any': 'error',
+    'typescript/no-extra-non-null-assertion': 'error',
+    'typescript/no-extraneous-class': 'error',
+    'typescript/no-floating-promises': 'error',
+    'typescript/no-for-in-array': 'error',
+    'typescript/no-import-type-side-effects': 'warn',
+    'typescript/no-implied-eval': 'error',
+    'typescript/no-inferrable-types': 'error',
+    'typescript/no-invalid-void-type': 'error',
+    'typescript/no-meaningless-void-operator': 'error',
+    'typescript/no-misused-new': 'error',
+    'typescript/no-misused-promises': 'error',
+    'typescript/no-mixed-enums': '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': 'error',
+    'typescript/no-redundant-type-constituents': 'warn',
+    'typescript/no-require-imports': 'error',
+    'typescript/no-this-alias': 'error',
+    'typescript/no-unnecessary-boolean-literal-compare': 'error',
+    'typescript/no-unnecessary-condition': 'error',
+    'typescript/no-unnecessary-qualifier': 'warn',
+    'typescript/no-unnecessary-template-expression': 'error',
+    'typescript/no-unnecessary-type-arguments': 'error',
+    'typescript/no-unnecessary-type-assertion': 'error',
+    'typescript/no-unnecessary-type-constraint': 'error',
+    'typescript/no-unnecessary-type-conversion': 'error',
+    'typescript/no-unnecessary-type-parameters': 'error',
+    'typescript/no-unsafe-argument': 'error',
+    'typescript/no-unsafe-assignment': 'error',
+    'typescript/no-unsafe-call': 'error',
+    'typescript/no-unsafe-declaration-merging': 'error',
+    'typescript/no-unsafe-enum-comparison': 'error',
+    'typescript/no-unsafe-function-type': 'error',
+    'typescript/no-unsafe-member-access': 'error',
+    'typescript/no-unsafe-return': 'error',
+    'typescript/no-unsafe-unary-minus': 'error',
+    'typescript/no-wrapper-object-types': 'error',
+    'typescript/non-nullable-type-assertion-style': 'error',
+    'typescript/only-throw-error': 'error',
+    'typescript/prefer-as-const': 'error',
+    'typescript/prefer-find': 'error',
+    'typescript/prefer-for-of': 'error',
+    'typescript/prefer-function-type': 'error',
+    'typescript/prefer-includes': 'error',
+    'typescript/prefer-literal-enum-member': 'error',
+    'typescript/prefer-namespace-keyword': 'error',
+    'typescript/prefer-nullish-coalescing': [
+      'error',
+      { ignorePrimitives: { bigint: true, boolean: true, number: true, string: true } },
+    ],
+    'typescript/prefer-optional-chain': 'error',
+    'typescript/prefer-promise-reject-errors': 'error',
+    'typescript/prefer-reduce-type-parameter': 'error',
+    'typescript/prefer-regexp-exec': 'error',
+    'typescript/prefer-return-this-type': 'error',
+    'typescript/prefer-string-starts-ends-with': 'error',
+    'typescript/related-getter-setter-pairs': 'error',
+    'typescript/require-array-sort-compare': 'error',
+    'typescript/require-await': 'error',
+    'typescript/restrict-plus-operands': 'error',
+    'typescript/return-await': ['error', 'error-handling-correctness-only'],
+    'typescript/restrict-template-expressions': 'error',
+    'typescript/switch-exhaustiveness-check': 'error',
+    'typescript/triple-slash-reference': 'off',
+    'typescript/unbound-method': 'error',
+    'typescript/unified-signatures': 'error',
+    'typescript/use-unknown-in-catch-callback-variable': 'error',
+    'default-param-last': 'error',
+    'no-array-constructor': 'error',
+    'no-empty-function': 'error',
+    'no-loop-func': 'error',
+    'no-unused-expressions': 'error',
+    'no-unused-vars': [
+      'error',
+      {
+        args: 'all',
+        argsIgnorePattern: '^_',
+        caughtErrors: 'all',
+        caughtErrorsIgnorePattern: '^_',
+        destructuredArrayIgnorePattern: '^_',
+        varsIgnorePattern: '^_',
+        ignoreRestSiblings: true,
+      },
+    ],
+    'no-useless-constructor': 'error',
+    // Unicorn
+    'unicorn/error-message': 'error',
+    'unicorn/no-empty-file': 'error',
+    'unicorn/no-instanceof-builtins': 'error',
+    'unicorn/no-useless-spread': 'warn',
+    'unicorn/prefer-array-flat-map': 'warn',
+    'unicorn/prefer-node-protocol': 'warn',
+    'unicorn/throw-new-error': 'error',
+  },
+  overrides: [
+    {
+      // JS files carry no types, so type-aware rules only report `any` noise, as typescript-eslint `disableTypeChecked` does
+      files: ['**/*.{js,cjs,mjs}'],
+      rules: {
+        'typescript/await-thenable': 'off',
+        'typescript/consistent-type-exports': 'off',
+        'typescript/dot-notation': 'off',
+        'typescript/no-array-delete': 'off',
+        'typescript/no-base-to-string': 'off',
+        'typescript/no-confusing-void-expression': 'off',
+        'typescript/no-deprecated': 'off',
+        'typescript/no-duplicate-type-constituents': 'off',
+        'typescript/no-floating-promises': 'off',
+        'typescript/no-for-in-array': 'off',
+        'typescript/no-implied-eval': 'off',
+        'typescript/no-meaningless-void-operator': 'off',
+        'typescript/no-misused-promises': 'off',
+        'typescript/no-misused-spread': 'off',
+        'typescript/no-mixed-enums': 'off',
+        'typescript/no-redundant-type-constituents': 'off',
+        'typescript/no-unnecessary-boolean-literal-compare': 'off',
+        'typescript/no-unnecessary-condition': 'off',
+        'typescript/no-unnecessary-qualifier': 'off',
+        'typescript/no-unnecessary-template-expression': 'off',
+        'typescript/no-unnecessary-type-arguments': 'off',
+        'typescript/no-unnecessary-type-assertion': 'off',
+        'typescript/no-unnecessary-type-conversion': 'off',
+        'typescript/no-unnecessary-type-parameters': 'off',
+        'typescript/no-unsafe-argument': 'off',
+        'typescript/no-unsafe-assignment': 'off',
+        'typescript/no-unsafe-call': 'off',
+        'typescript/no-unsafe-enum-comparison': 'off',
+        'typescript/no-unsafe-member-access': 'off',
+        'typescript/no-unsafe-return': 'off',
+        'typescript/no-unsafe-unary-minus': 'off',
+        'typescript/no-useless-default-assignment': 'off',
+        'typescript/non-nullable-type-assertion-style': 'off',
+        'typescript/only-throw-error': 'off',
+        'typescript/prefer-find': 'off',
+        'typescript/prefer-includes': 'off',
+        'typescript/prefer-nullish-coalescing': 'off',
+        'typescript/prefer-optional-chain': 'off',
+        'typescript/prefer-promise-reject-errors': 'off',
+        'typescript/prefer-reduce-type-parameter': 'off',
+        'typescript/prefer-regexp-exec': 'off',
+        'typescript/prefer-return-this-type': 'off',
+        'typescript/prefer-string-starts-ends-with': 'off',
+        'typescript/related-getter-setter-pairs': 'off',
+        'typescript/require-array-sort-compare': 'off',
+        'typescript/require-await': 'off',
+        'typescript/restrict-plus-operands': 'off',
+        'typescript/restrict-template-expressions': 'off',
+        'typescript/return-await': 'off',
+        'typescript/switch-exhaustiveness-check': 'off',
+        'typescript/unbound-method': 'off',
+        'typescript/use-unknown-in-catch-callback-variable': 'off',
+      },
+    },
+  ],
+}

package/src/next.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/next.js

@@ -0,0 +1,31 @@
+import { reactConfig } from './react.js'
+
+/** @type {import('oxlint').OxlintConfig} */
+export default reactConfig({
+  env: { browser: true, node: true },
+  plugins: ['nextjs'],
+  rules: {
+    'check-file/folder-naming-convention': ['error', { '**/src/**/': 'NEXT_JS_APP_ROUTER_CASE' }],
+    'nextjs/google-font-display': 'warn',
+    'nextjs/google-font-preconnect': 'warn',
+    'nextjs/inline-script-id': 'error',
+    'nextjs/next-script-for-ga': 'warn',
+    'nextjs/no-assign-module-variable': 'error',
+    'nextjs/no-async-client-component': 'warn',
+    'nextjs/no-before-interactive-script-outside-document': 'warn',
+    'nextjs/no-css-tags': 'warn',
+    'nextjs/no-document-import-in-page': 'error',
+    'nextjs/no-duplicate-head': 'error',
+    'nextjs/no-head-element': 'warn',
+    'nextjs/no-head-import-in-document': 'error',
+    'nextjs/no-html-link-for-pages': 'error',
+    'nextjs/no-img-element': 'warn',
+    'nextjs/no-page-custom-font': 'warn',
+    'nextjs/no-script-component-in-head': 'error',
+    'nextjs/no-styled-jsx-in-document': 'warn',
+    'nextjs/no-sync-scripts': 'error',
+    'nextjs/no-title-in-document-head': 'warn',
+    'nextjs/no-typos': 'warn',
+    'nextjs/no-unwanted-polyfillio': 'warn',
+  },
+})

package/src/react-vite.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/react-vite.js

@@ -0,0 +1,7 @@
+import { reactConfig } from './react.js'
+
+/** @type {import('oxlint').OxlintConfig} */
+export default reactConfig({
+  env: { browser: true },
+  rules: { 'react/only-export-components': ['error', { allowConstantExport: true }] },
+})

package/src/react.js

@@ -0,0 +1,93 @@
+import { jsPlugin } from './js-plugins.js'
+
+/**
+ * React config shared by the Framework entries. Rules from `eslint-plugin-react`,
+ * `eslint-plugin-react-hooks` and `eslint-plugin-jsx-a11y` are native in oxlint, except the
+ * `react-js` ones, which load `eslint-plugin-react` as a JS plugin.
+ */
+export function reactConfig({ env, plugins = [], rules = {} }) {
+  return {
+    plugins: ['jsx-a11y', 'react', ...plugins],
+    jsPlugins: [jsPlugin('react-js', 'eslint-plugin-react')],
+    env,
+    settings: { react: { version: '19' } },
+    rules: {
+      // react
+      'react/display-name': 'error',
+      'react/function-component-definition': 'warn',
+      'react/hook-use-state': 'error',
+      'react/jsx-boolean-value': 'warn',
+      'react/jsx-curly-brace-presence': 'warn',
+      'react/jsx-fragments': 'warn',
+      'react/jsx-key': 'error',
+      'react/jsx-no-comment-textnodes': 'error',
+      'react/jsx-no-duplicate-props': 'error',
+      'react/jsx-no-target-blank': ['error', { allowReferrer: true }],
+      'react/jsx-no-undef': 'error',
+      'react/jsx-no-useless-fragment': ['warn', { allowExpressions: true }],
+      'react/no-array-index-key': 'warn',
+      'react/no-children-prop': 'error',
+      'react/no-danger-with-children': 'error',
+      'react/no-direct-mutation-state': 'error',
+      'react/no-find-dom-node': 'error',
+      'react/no-is-mounted': 'error',
+      'react/no-render-return-value': 'error',
+      'react/no-string-refs': 'error',
+      'react/no-unescaped-entities': 'error',
+      'react/no-unknown-property': 'error',
+      'react/no-unstable-nested-components': 'error',
+      'react/require-render-return': 'error',
+      'react/self-closing-comp': 'warn',
+      'react-js/jsx-no-leaked-render': 'warn',
+      'react-js/jsx-sort-props': 'warn',
+      // react-hooks
+      'react/error-boundaries': 'error',
+      'react/exhaustive-deps': 'warn',
+      'react/globals': 'error',
+      'react/immutability': 'error',
+      'react/incompatible-library': 'warn',
+      'react/preserve-manual-memoization': 'error',
+      'react/purity': 'error',
+      'react/refs': 'error',
+      'react/rules-of-hooks': 'error',
+      'react/set-state-in-effect': 'error',
+      'react/set-state-in-render': 'error',
+      'react/static-components': 'error',
+      'react/unsupported-syntax': 'warn',
+      'react/use-memo': 'error',
+      // jsx-a11y
+      'jsx-a11y/alt-text': 'error',
+      'jsx-a11y/anchor-has-content': 'error',
+      'jsx-a11y/anchor-is-valid': 'error',
+      'jsx-a11y/aria-activedescendant-has-tabindex': 'error',
+      'jsx-a11y/aria-props': 'error',
+      'jsx-a11y/aria-proptypes': 'error',
+      'jsx-a11y/aria-role': 'error',
+      'jsx-a11y/aria-unsupported-elements': 'error',
+      'jsx-a11y/autocomplete-valid': 'error',
+      'jsx-a11y/click-events-have-key-events': 'error',
+      'jsx-a11y/heading-has-content': 'error',
+      'jsx-a11y/html-has-lang': 'error',
+      'jsx-a11y/iframe-has-title': 'error',
+      'jsx-a11y/img-redundant-alt': 'error',
+      'jsx-a11y/interactive-supports-focus': 'error',
+      'jsx-a11y/label-has-associated-control': 'error',
+      'jsx-a11y/media-has-caption': 'error',
+      'jsx-a11y/mouse-events-have-key-events': 'error',
+      'jsx-a11y/no-access-key': 'error',
+      'jsx-a11y/no-autofocus': 'error',
+      'jsx-a11y/no-distracting-elements': 'error',
+      'jsx-a11y/no-interactive-element-to-noninteractive-role': 'error',
+      'jsx-a11y/no-noninteractive-element-interactions': 'error',
+      'jsx-a11y/no-noninteractive-element-to-interactive-role': 'error',
+      'jsx-a11y/no-noninteractive-tabindex': 'error',
+      'jsx-a11y/no-redundant-roles': 'error',
+      'jsx-a11y/no-static-element-interactions': 'error',
+      'jsx-a11y/role-has-required-aria-props': 'error',
+      'jsx-a11y/role-supports-aria-props': 'error',
+      'jsx-a11y/scope': 'error',
+      'jsx-a11y/tabindex-no-positive': 'error',
+      ...rules,
+    },
+  }
+}

package/src/tailwind.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/tailwind.js

@@ -0,0 +1,13 @@
+import { jsPlugin } from './js-plugins.js'
+
+/** @type {import('oxlint').OxlintConfig} */
+export default {
+  jsPlugins: [jsPlugin('shadcn', '@shadcn/lint')],
+  rules: {
+    'shadcn/no-arbitrary-values': 'error',
+    'shadcn/no-inline-styles': 'error',
+    'shadcn/no-raw-colors': 'error',
+    'shadcn/no-restyle': 'error',
+    'shadcn/no-unknown-classes': 'error',
+  },
+}

package/src/tanstack-start.d.ts

@@ -0,0 +1,4 @@
+import type { OxlintConfig } from 'oxlint'
+
+declare const config: OxlintConfig
+export default config

package/src/tanstack-start.js

@@ -0,0 +1,14 @@
+import { reactConfig } from './react.js'
+
+const config = reactConfig({ env: { browser: true, node: true } })
+
+/** @type {import('oxlint').OxlintConfig} */
+export default {
+  ...config,
+  overrides: [
+    {
+      files: ['**/routes/**'],
+      rules: { 'check-file/folder-naming-convention': 'off', 'unicorn/filename-case': 'off' },
+    },
+  ],
+}