@santux/eslint-config 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,85 @@
-# Temporary Holding Version
+# @santux/eslint-config
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared ESLint, Prettier and commitlint config for TypeScript projects.
+
+## Entries
+
+| Entry                                   | Tool       | Export            |
+| --------------------------------------- | ---------- | ----------------- |
+| `@santux/eslint-config/lint`            | ESLint 9   | Flat config array |
+| `@santux/eslint-config/next`            | ESLint 9   | Flat config array |
+| `@santux/eslint-config/react-vite`      | ESLint 9   | Flat config array |
+| `@santux/eslint-config/tanstack-start`  | ESLint 9   | Flat config array |
+| `@santux/eslint-config/astro`           | ESLint 9   | Flat config array |
+| `@santux/eslint-config/astro-react`     | ESLint 9   | Flat config array |
+| `@santux/eslint-config/tailwind`        | ESLint 9   | Flat config array |
+| `@santux/eslint-config/format`          | Prettier   | Config object     |
+| `@santux/eslint-config/format-astro`    | Prettier   | Config object     |
+| `@santux/eslint-config/format-tailwind` | Prettier   | Config object     |
+| `@santux/eslint-config/commitlint`      | commitlint | Config object     |
+
+The lint entry uses typescript-eslint `strictTypeChecked` + `stylisticTypeChecked`, `eslint-plugin-import-x` (with the TypeScript import resolver, so `no-cycle`, `no-self-import` and `no-extraneous-dependencies` work on `.ts`/`.tsx`), unicorn and check-file naming.
+
+The `next` entry builds on the lint entry with react, react-hooks, jsx-a11y and Next.js rules (`react.version` is `19`). Compose it after the base: `defineConfig([santux, next])`. Its plugins (`@next/eslint-plugin-next`, `eslint-plugin-react`, `eslint-plugin-react-hooks`, `eslint-plugin-jsx-a11y`, `globals`) are optional peer dependencies, needed only when you use it.
+
+The `react-vite` entry builds on the lint entry the same way, with react, react-hooks, jsx-a11y and react-refresh rules. Its plugins (`eslint-plugin-react`, `eslint-plugin-react-hooks`, `eslint-plugin-jsx-a11y`, `eslint-plugin-react-refresh`, `globals`) are optional peer dependencies.
+
+The `tanstack-start` entry builds on the lint entry the same way, with react, react-hooks and jsx-a11y rules and browser plus Node globals. Its plugins (`eslint-plugin-react`, `eslint-plugin-react-hooks`, `eslint-plugin-jsx-a11y`, `globals`) are optional peer dependencies.
+
+The `astro` entry builds on the lint entry with the `eslint-plugin-astro` recommended rules and its jsx-a11y rules for `.astro` files, plus browser and Node globals. It parses `.astro` files with TypeScript and runs the type-aware rules there too, allows the `Props` interface Astro reads component props from, ignores `.astro/` and turns off the file and folder name rules under `pages`. Its plugins (`eslint-plugin-astro`, `eslint-plugin-jsx-a11y`, `globals`) are optional peer dependencies. `eslint-plugin-astro` stays on 1.7.0, the last version that supports ESLint 9, until this package moves to ESLint 10.
+
+The `astro-react` entry adds the react, react-hooks and jsx-a11y rules to the `.jsx` and `.tsx` files of an Astro project with React islands (`@astrojs/react`), without react-refresh. Compose it after the `astro` entry: `defineConfig([santux, astro, astroReact])`. It needs `eslint-plugin-react` and `eslint-plugin-react-hooks`, optional peer dependencies.
+
+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`. Compose it after the Framework entry: `defineConfig([santux, next, tailwind])`.
+
+The `format-tailwind` entry is a Prettier config fragment that sorts Tailwind classes with `prettier-plugin-tailwindcss` (an optional peer dependency). Spread it after the format entry: `export default { ...santux, ...formatTailwind }`. For Tailwind v4 projects with a custom stylesheet, also set `tailwindStylesheet` in your Prettier config.
+
+The `format-astro` entry formats `.astro` files with `prettier-plugin-astro` (an optional peer dependency), pinned to 0.14.1 because `prettier-plugin-tailwindcss` does not sort classes in `.astro` files with its 1.x. Spreading two entries keeps only the last `plugins`, so merge them with the Tailwind plugin last:
+
+```js
+export default {
+  ...santux,
+  ...formatAstro,
+  ...formatTailwind,
+  plugins: [...formatAstro.plugins, ...formatTailwind.plugins],
+}
+```
+
+## Usage
+
+Every tool is an exact-version peer dependency and must be installed in your project:
+
+```sh
+pnpm add -D @santux/eslint-config @commitlint/cli @commitlint/config-conventional @eslint/js @stylistic/eslint-plugin eslint eslint-config-prettier eslint-import-resolver-typescript eslint-plugin-check-file eslint-plugin-import-x eslint-plugin-unicorn husky prettier typescript typescript-eslint
+```
+
+```js
+// eslint.config.js
+import santux from '@santux/eslint-config/lint'
+import { defineConfig } from 'eslint/config'
+
+export default defineConfig([
+  santux,
+  // Override, disable or add rules locally
+  { rules: { 'no-console': 'off', 'unicorn/prefer-node-protocol': 'error' } },
+  { files: ['**/*.test.ts'], rules: { '@typescript-eslint/no-non-null-assertion': 'off' } },
+])
+```
+
+```js
+// prettier.config.js
+import santux from '@santux/eslint-config/format'
+
+export default { ...santux, printWidth: 120 }
+```
+
+```js
+// commitlint.config.js
+export { default } from '@santux/eslint-config/commitlint'
+```
+
+Requires Node `>=22.18`.
+
+## 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,6 +1,172 @@
 {
   "name": "@santux/eslint-config",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Shared ESLint, Prettier and commitlint config for TypeScript projects.",
+  "keywords": [
+    "commitlint",
+    "eslint",
+    "eslint-config",
+    "prettier"
+  ],
+  "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/eslint-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-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": {
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@eslint/js": "9.39.5",
+    "@next/eslint-plugin-next": "16.4.6",
+    "@shadcn/lint": "0.2.5",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "eslint": "9.39.5",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-import-resolver-typescript": "4.4.5",
+    "eslint-plugin-astro": "1.7.0",
+    "eslint-plugin-check-file": "3.3.2",
+    "eslint-plugin-import-x": "4.18.1",
+    "eslint-plugin-jsx-a11y": "6.10.2",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "7.1.1",
+    "eslint-plugin-react-refresh": "0.5.7",
+    "eslint-plugin-unicorn": "65.0.1",
+    "globals": "17.14.0",
+    "husky": "9.1.7",
+    "prettier": "3.10.1",
+    "prettier-plugin-astro": "0.14.1",
+    "prettier-plugin-tailwindcss": "0.8.1",
+    "tailwindcss": "4.3.5",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.72.2",
+    "vitest": "5.1.0"
+  },
+  "peerDependencies": {
+    "@commitlint/cli": "21.2.4",
+    "@commitlint/config-conventional": "21.2.4",
+    "@eslint/js": "9.39.5",
+    "@next/eslint-plugin-next": "16.4.6",
+    "@shadcn/lint": "0.2.5",
+    "@stylistic/eslint-plugin": "5.10.0",
+    "@typescript/typescript6": "6.0.2",
+    "eslint": "9.39.5",
+    "eslint-config-prettier": "10.1.8",
+    "eslint-import-resolver-typescript": "4.4.5",
+    "eslint-plugin-astro": "1.7.0",
+    "eslint-plugin-check-file": "3.3.2",
+    "eslint-plugin-import-x": "4.18.1",
+    "eslint-plugin-jsx-a11y": "6.10.2",
+    "eslint-plugin-react": "7.37.5",
+    "eslint-plugin-react-hooks": "7.1.1",
+    "eslint-plugin-react-refresh": "0.5.7",
+    "eslint-plugin-unicorn": "65.0.1",
+    "globals": "17.14.0",
+    "husky": "9.1.7",
+    "prettier": "3.10.1",
+    "prettier-plugin-astro": "0.14.1",
+    "prettier-plugin-tailwindcss": "0.8.1",
+    "typescript-eslint": "8.72.2"
+  },
+  "peerDependenciesMeta": {
+    "@next/eslint-plugin-next": {
+      "optional": true
+    },
+    "@shadcn/lint": {
+      "optional": true
+    },
+    "@typescript/typescript6": {
+      "optional": true
+    },
+    "eslint-plugin-astro": {
+      "optional": true
+    },
+    "eslint-plugin-jsx-a11y": {
+      "optional": true
+    },
+    "eslint-plugin-react": {
+      "optional": true
+    },
+    "eslint-plugin-react-hooks": {
+      "optional": true
+    },
+    "eslint-plugin-react-refresh": {
+      "optional": true
+    },
+    "globals": {
+      "optional": true
+    },
+    "prettier-plugin-astro": {
+      "optional": true
+    },
+    "prettier-plugin-tailwindcss": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.18"
+  }
+}

package/src/astro-react.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/astro-react.js

@@ -0,0 +1,6 @@
+import { defineConfig } from 'eslint/config'
+import globals from 'globals'
+
+import { reactConfig } from './react.js'
+
+export default defineConfig([{ ...reactConfig(globals.browser), files: ['**/*.{jsx,tsx}'] }])

package/src/astro.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/astro.js

@@ -0,0 +1,68 @@
+import { createRequire } from 'node:module'
+
+import astroPlugin from 'eslint-plugin-astro'
+import jsxA11yPlugin from 'eslint-plugin-jsx-a11y'
+import { defineConfig, globalIgnores } from 'eslint/config'
+import globals from 'globals'
+import tsEslint from 'typescript-eslint'
+
+// The rules of eslint-plugin-astro's `jsx-a11y-recommended` config, limited to .astro files. The
+// config itself registers its own copy of the `jsx-a11y` plugin, which clashes with the React rules
+const a11yRules = Object.fromEntries(
+  Object.entries(jsxA11yPlugin.flatConfigs.recommended.rules).map(([name, entry]) => [
+    `astro/${name}`,
+    entry,
+  ]),
+)
+
+// import-x parses the modules an .astro file imports with the .astro parser unless told otherwise
+const tsParserPath = createRequire(import.meta.resolve('typescript-eslint')).resolve(
+  '@typescript-eslint/parser',
+)
+
+export default defineConfig([
+  globalIgnores(['**/.astro/**']),
+  astroPlugin.configs['flat/recommended'],
+  {
+    files: ['**/*.astro'],
+    // eslint-plugin-astro only picks the TS parser and the TS <script> processor when it finds the
+    // parser hoisted to the project root, and astro-eslint-parser does not support `projectService`
+    processor: 'astro/client-side-ts',
+    languageOptions: {
+      parserOptions: {
+        parser: tsEslint.parser,
+        extraFileExtensions: ['.astro'],
+        project: true,
+        projectService: false,
+      },
+    },
+    settings: {
+      'import-x/parsers': {
+        [tsParserPath]: ['.js', '.cjs', '.mjs', '.jsx', '.ts', '.cts', '.mts', '.tsx'],
+      },
+    },
+    rules: {
+      ...a11yRules,
+      // Astro types a component's props through an interface named `Props`
+      '@typescript-eslint/naming-convention': [
+        'error',
+        { format: ['PascalCase'], selector: ['typeLike', 'enumMember'] },
+        {
+          custom: { match: false, regex: '^I[A-Z]|^(Interface|State)$' },
+          format: ['PascalCase'],
+          selector: 'interface',
+        },
+      ],
+    },
+  },
+  // The <script> blocks are virtual files that no tsconfig includes, so they get no type information
+  { files: ['**/*.astro/*.ts'], ...tsEslint.configs.disableTypeChecked },
+  {
+    files: ['**/pages/**'],
+    rules: {
+      'check-file/filename-naming-convention': 'off',
+      'check-file/folder-naming-convention': 'off',
+    },
+  },
+  { languageOptions: { globals: { ...globals.browser, ...globals.node } } },
+])

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 { Config } from 'prettier'
+
+declare const config: Config
+export default config

package/src/format-astro.js

@@ -0,0 +1,5 @@
+/** @type {import('prettier').Config} */
+export default {
+  plugins: ['prettier-plugin-astro'],
+  overrides: [{ files: '*.astro', options: { parser: 'astro' } }],
+}

package/src/format-tailwind.d.ts

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

package/src/format-tailwind.js

@@ -0,0 +1,4 @@
+/** @type {import('prettier').Config} */
+export default {
+  plugins: ['prettier-plugin-tailwindcss'],
+}

package/src/format.d.ts

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

package/src/format.js

@@ -0,0 +1,15 @@
+/** @type {import('prettier').Config} */
+export default {
+  arrowParens: 'always',
+  bracketSameLine: false,
+  bracketSpacing: true,
+  endOfLine: 'auto',
+  jsxSingleQuote: true,
+  printWidth: 100,
+  quoteProps: 'as-needed',
+  semi: false,
+  singleQuote: true,
+  tabWidth: 2,
+  trailingComma: 'all',
+  useTabs: false,
+}

package/src/import-order.d.ts

@@ -0,0 +1 @@
+export declare function importOrder(earlyPackages: string[]): [string, object]

package/src/import-order.js

@@ -0,0 +1,17 @@
+/** `import-x/order` options. Packages in `earlyPackages` are grouped before the other builtins. */
+export function importOrder(earlyPackages) {
+  return [
+    'warn',
+    {
+      alphabetize: { order: 'asc', caseInsensitive: true },
+      groups: ['type', 'builtin', 'external', 'internal', 'parent', 'sibling', 'index'],
+      'newlines-between': 'always',
+      pathGroups: [
+        { pattern: '@/**', group: 'internal', position: 'after' },
+        { pattern: `{${earlyPackages.join(',')}}`, group: 'builtin', position: 'before' },
+      ],
+      pathGroupsExcludedImportTypes: ['builtin', 'internal'],
+      warnOnUnassignedImports: true,
+    },
+  ]
+}

package/src/lint.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/lint.js

@@ -0,0 +1,169 @@
+import eslint from '@eslint/js'
+import stylistic from '@stylistic/eslint-plugin'
+import eslintConfigPrettier from 'eslint-config-prettier/flat'
+import { createTypeScriptImportResolver } from 'eslint-import-resolver-typescript'
+import checkFilePlugin from 'eslint-plugin-check-file'
+import { importX } from 'eslint-plugin-import-x'
+import unicornPlugin from 'eslint-plugin-unicorn'
+import { defineConfig, globalIgnores } from 'eslint/config'
+import tsEslint from 'typescript-eslint'
+
+import { importOrder } from './import-order.js'
+
+export default defineConfig([
+  globalIgnores(['**/node_modules', '**/build', '**/dist']),
+  // Vanilla ESLint
+  {
+    extends: [eslint.configs.recommended],
+    rules: {
+      eqeqeq: ['error', 'always', { null: 'ignore' }],
+      'no-await-in-loop': 'error',
+      'no-console': 'error',
+      'no-else-return': 'warn',
+      'no-implicit-coercion': 'error',
+      'no-param-reassign': 'error',
+      'no-self-compare': 'error',
+      'no-undef-init': 'warn',
+      'no-unneeded-ternary': 'error',
+      'no-var': 'error',
+      'object-shorthand': 'warn',
+      'prefer-object-spread': 'warn',
+      'prefer-rest-params': 'error',
+      'prefer-spread': 'error',
+      'prefer-template': 'warn',
+    },
+  },
+  // Check files
+  {
+    plugins: { 'check-file': checkFilePlugin },
+    rules: {
+      'check-file/filename-naming-convention': [
+        'error',
+        { '**/*.{js,jsx,ts,tsx}': 'KEBAB_CASE' },
+        { ignoreMiddleExtensions: true },
+      ],
+      'check-file/folder-naming-convention': ['error', { '**/src/**/': 'KEBAB_CASE' }],
+    },
+  },
+  // Import order
+  {
+    plugins: { 'import-x': importX },
+    settings: {
+      'import-x/extensions': ['.js', '.jsx', '.ts', '.tsx'],
+      'import-x/resolver-next': [createTypeScriptImportResolver()],
+    },
+    rules: {
+      'import-x/first': 'error',
+      'import-x/newline-after-import': 'warn',
+      'import-x/no-duplicates': ['warn', { 'prefer-inline': true }],
+      'import-x/no-cycle': 'error',
+      'import-x/no-extraneous-dependencies': ['error', { includeTypes: true }],
+      'import-x/no-mutable-exports': 'error',
+      'import-x/no-self-import': 'error',
+      'import-x/no-useless-path-segments': 'error',
+      'import-x/order': importOrder(['react', 'react-dom', 'react-dom/**']),
+    },
+  },
+  // Stylistic
+  {
+    plugins: { '@stylistic': stylistic },
+    rules: {
+      '@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
+  {
+    extends: [tsEslint.configs.strictTypeChecked, tsEslint.configs.stylisticTypeChecked],
+    languageOptions: { parserOptions: { projectService: true } },
+    rules: {
+      '@typescript-eslint/consistent-type-exports': [
+        'warn',
+        { fixMixedExportsWithInlineTypeSpecifier: true },
+      ],
+      '@typescript-eslint/consistent-type-imports': ['warn', { fixStyle: 'inline-type-imports' }],
+      '@typescript-eslint/default-param-last': 'error',
+      '@typescript-eslint/member-ordering': [
+        'error',
+        { interfaces: { order: 'natural-case-insensitive' } },
+      ],
+      '@typescript-eslint/method-signature-style': 'warn',
+      '@typescript-eslint/naming-convention': [
+        'error',
+        { format: ['PascalCase'], selector: ['typeLike', 'enumMember'] },
+        {
+          custom: {
+            match: false,
+            regex: '^I[A-Z]|^(Interface|Props|State)$',
+          },
+          format: ['PascalCase'],
+          selector: 'interface',
+        },
+      ],
+      '@typescript-eslint/no-import-type-side-effects': 'warn',
+      '@typescript-eslint/no-confusing-void-expression': ['error', { ignoreArrowShorthand: true }],
+      '@typescript-eslint/no-loop-func': 'error',
+      '@typescript-eslint/no-redundant-type-constituents': 'warn',
+      '@typescript-eslint/no-unnecessary-qualifier': 'warn',
+      '@typescript-eslint/no-unused-vars': [
+        'error',
+        {
+          args: 'all',
+          argsIgnorePattern: '^_',
+          caughtErrors: 'all',
+          caughtErrorsIgnorePattern: '^_',
+          destructuredArrayIgnorePattern: '^_',
+          varsIgnorePattern: '^_',
+          ignoreRestSiblings: true,
+        },
+      ],
+      '@typescript-eslint/prefer-nullish-coalescing': [
+        'error',
+        {
+          ignorePrimitives: {
+            bigint: true,
+            boolean: true,
+            number: true,
+            string: true,
+          },
+        },
+      ],
+      '@typescript-eslint/require-array-sort-compare': 'error',
+      '@typescript-eslint/switch-exhaustiveness-check': 'error',
+      '@typescript-eslint/triple-slash-reference': 'off',
+      // After the typescript-eslint presets, which set it to error in TypeScript files
+      'prefer-const': 'warn',
+    },
+  },
+  // Disable type checked in .js files
+  {
+    files: ['**/*.{js,cjs,mjs}'],
+    ...tsEslint.configs.disableTypeChecked,
+  },
+  // Unicorn
+  {
+    plugins: { unicorn: unicornPlugin },
+    rules: {
+      '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',
+    },
+  },
+  // Prettier
+  eslintConfigPrettier,
+])

package/src/next.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/next.js

@@ -0,0 +1,18 @@
+import nextPlugin from '@next/eslint-plugin-next'
+import { defineConfig, globalIgnores } from 'eslint/config'
+import globals from 'globals'
+
+import { importOrder } from './import-order.js'
+import { reactConfig } from './react.js'
+
+export default defineConfig([
+  globalIgnores(['**/.next/**', '**/out/**', '**/next-env.d.ts']),
+  {
+    rules: {
+      'check-file/folder-naming-convention': ['error', { '**/src/**/': 'NEXT_JS_APP_ROUTER_CASE' }],
+      'import-x/order': importOrder(['next', 'next/**', 'react', 'react-dom', 'react-dom/**']),
+    },
+  },
+  nextPlugin.configs['core-web-vitals'],
+  reactConfig({ ...globals.browser, ...globals.node }),
+])

package/src/react-vite.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/react-vite.js

@@ -0,0 +1,15 @@
+import reactRefreshPlugin from 'eslint-plugin-react-refresh'
+import { defineConfig } from 'eslint/config'
+import globals from 'globals'
+
+import { importOrder } from './import-order.js'
+import { reactConfig } from './react.js'
+
+export default defineConfig([
+  {
+    rules: {
+      'import-x/order': importOrder(['react', 'react-dom', 'react-dom/**']),
+    },
+  },
+  reactConfig(globals.browser, [reactRefreshPlugin.configs.vite]),
+])

package/src/react.d.ts

@@ -0,0 +1,6 @@
+import type { Config } from 'eslint/config'
+
+export declare function reactConfig(
+  globals: Record<string, boolean | 'readonly' | 'writable' | 'off'>,
+  extraExtends?: Config[],
+): Config

package/src/react.js

@@ -0,0 +1,37 @@
+import jsxA11yPlugin from 'eslint-plugin-jsx-a11y'
+import reactPlugin from 'eslint-plugin-react'
+import reactHooksPlugin from 'eslint-plugin-react-hooks'
+
+/** React config block shared by the Framework entries. `extraExtends` go after the React presets. */
+export function reactConfig(globals, extraExtends = []) {
+  return {
+    files: ['**/*.{js,mjs,cjs,jsx,ts,tsx}'],
+    extends: [
+      reactPlugin.configs.flat.recommended,
+      reactPlugin.configs.flat['jsx-runtime'],
+      reactHooksPlugin.configs.flat['recommended-latest'],
+      jsxA11yPlugin.flatConfigs.recommended,
+      ...extraExtends,
+    ],
+    languageOptions: {
+      globals,
+      parserOptions: { ecmaFeatures: { jsx: true } },
+    },
+    rules: {
+      '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-no-leaked-render': 'warn',
+      'react/jsx-no-target-blank': ['error', { allowReferrer: true }],
+      'react/jsx-no-useless-fragment': ['warn', { allowExpressions: true }],
+      'react/jsx-sort-props': ['warn', { noSortAlphabetically: false }],
+      'react/no-array-index-key': 'warn',
+      'react/no-unstable-nested-components': 'error',
+      'react/prop-types': 'off',
+      'react/self-closing-comp': 'warn',
+    },
+    settings: { react: { version: '19' } },
+  }
+}

package/src/tailwind.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/tailwind.js

@@ -0,0 +1,16 @@
+import { plugin as shadcnPlugin } from '@shadcn/lint'
+import { defineConfig } from 'eslint/config'
+
+export default defineConfig([
+  {
+    files: ['**/*.{js,mjs,cjs,jsx,ts,tsx}'],
+    plugins: { shadcn: shadcnPlugin },
+    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 { Config } from 'eslint/config'
+
+declare const config: Config[]
+export default config

package/src/tanstack-start.js

@@ -0,0 +1,22 @@
+import { defineConfig, globalIgnores } from 'eslint/config'
+import globals from 'globals'
+
+import { importOrder } from './import-order.js'
+import { reactConfig } from './react.js'
+
+export default defineConfig([
+  globalIgnores(['**/.output/**', '**/.tanstack/**', '**/routeTree.gen.ts']),
+  {
+    rules: {
+      'import-x/order': importOrder(['react', 'react-dom', 'react-dom/**']),
+    },
+  },
+  {
+    files: ['**/routes/**'],
+    rules: {
+      'check-file/filename-naming-convention': 'off',
+      'check-file/folder-naming-convention': 'off',
+    },
+  },
+  reactConfig({ ...globals.browser, ...globals.node }),
+])