ci: add oxlint as fast pre-lint pass before ESLint

[benpsnyder]

🎯 Changes

Add oxlint (Rust-based linter, ~50-100x faster than ESLint) as a first-pass linter that runs before ESLint in CI. Oxlint handles the bulk of correctness rules in ~250ms across 691 files, letting ESLint focus only on rules it exclusively covers (cspell, type-aware typescript-eslint rules, import ordering, react-hooks).

This pattern is already used by Preact, Sentry, Renovate, and Kibana. The implementation follows the same approach used in the AnalogJS repo (v3-alpha branch).

What changed:

• New: oxlint.config.ts — typed config with defineConfig, plugins: typescript, vitest, import, react
• Modified: eslint.config.js — imports oxlint config via jiti, appends buildFromOxlintConfig() as last entry to auto-disable overlapping rules, sets reportUnusedDisableDirectives: 'off'
• Modified: package.json — adds test:oxlint script, adds it to test:pr/test:ci Nx targets and includedScripts
• Modified: packages/vue-query/src/__tests__/useMutation.test.ts — fix pre-existing unsafe optional chaining with a defensive check
• Modified: packages/react-query/src/__tests__/useQuery.promise.test.tsx — suppress false positive on vitest 3-arg describe() with options object
• New devDependencies: oxlint, eslint-plugin-oxlint, jiti

Also incorporated from other open PRs:

• All changes from fix(devtools): add explicit types to eslint config exports #10254 — @tanstack/eslint-config bump to 0.4.0, eslint-plugin-unused-imports, JSDoc type annotations + const config export style on all 31 eslint configs, no-shadow/pnpm/enforce-catalog/pnpm/json-enforce-catalog rule overrides
• Supersedes test(svelte-query/{queryOptions,infiniteQueryOptions}): add 'eslint-disable' for 'vitest/expect-expect' #9496 — vitest/expect-expect is now handled by oxlint at warn level, so the eslint-disable comments that PR adds are no longer needed

Rules that stay ESLint-only (no oxlint equivalent)

• @cspell/eslint-plugin (spell checking)
• @typescript-eslint/consistent-type-imports, array-type, naming-convention, method-signature-style
• @typescript-eslint/no-unnecessary-condition, no-unnecessary-type-assertion, no-for-in-array, require-await (type-aware)
• import/* rules (ordering, no-commonjs, no-duplicates)
• node/prefer-node-protocol
• @stylistic/spaced-comment
• sort-imports
• eslint-plugin-react-hooks

Related issues & PRs

Superseded by this PR (can be closed):

• fix(devtools): add explicit types to eslint config exports #10254 — all changes ported here (eslint config types, unused-imports plugin, rule overrides)
• test(svelte-query/{queryOptions,infiniteQueryOptions}): add 'eslint-disable' for 'vitest/expect-expect' #9496 — oxlint now handles vitest/expect-expect, making the eslint-disable comments unnecessary

Related but independent (not affected by this PR):

• eslint-plugin-query: support eslint v10 #10141 — eslint-plugin-query: support eslint v10 (plugin peer dep, separate scope)
• feat(eslint-plugin-query): add ESLint v10 to peer dependencies #10182 / fix(eslint-plugin-query): add ESLint v10 to peerDependencies #10152 — add ESLint v10 to eslint-plugin-query peer dependencies (competing PRs, separate scope)
• feat(eslint): add type-checked configuration for eslint plugin #8966 — add type-checked configuration for eslint plugin (new feature, separate scope)
• feat(eslint-plugin-query): add prefer-query-options rule #10184 — add prefer-query-options rule (new rule, separate scope)
• fix(eslint-plugin): normalize whitespace in allowList variable matching for multiline expressions #10337 — fix whitespace in allowList variable matching (bug fix, separate scope)
• test(eslint-plugin-query/no-void-query-fn): add coverage for prefetchQuery, prefetchInfiniteQuery, ensureQueryData, ensureInfiniteQueryData #10353 — add test coverage for no-void-query-fn rule (tests, separate scope)

This is PR 1 of 6 in the Oxc/Rolldown/tsdown modernization series.

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

[coderabbitai]

📝 Walkthrough

Walkthrough

Added oxlint integration: new oxlint.config.ts, dynamic loading in eslint.config.js via jiti to append oxlint-generated rules, updated scripts/devDependencies to run oxlint, and small test lint/assertion adjustments.

Changes

Cohort / File(s)	Summary
Oxlint integration eslint.config.js, oxlint.config.ts	Added oxlint.config.ts (plugins, envs, overrides) and refactored eslint.config.js to import('eslint').Linter.Config[] config, load oxlint.config.ts via jiti, append oxlint.buildFromOxlintConfig(...), add eslint-plugin-unused-imports and disable specific rules and unused-disable reporting.
Tooling / Scripts package.json	Added test:oxlint script, included it in test:pr and test:ci, updated nx.includedScripts, bumped @tanstack/eslint-config, added devDeps: oxlint, eslint-plugin-oxlint, eslint-plugin-unused-imports, jiti.
Test edits packages/react-query/src/__tests__/useQuery.promise.test.tsx, packages/vue-query/src/__tests__/useMutation.test.ts	Added ESLint disable for vitest/valid-describe-callback; refactored assertion to assert relevantMutation defined then check nested key.
ESLint export refactors (many examples/packages) examples/react/.../eslint.config.js, packages/.../eslint.config.js (multiple files across examples and packages, see diff)	Replaced inline export default [...] array exports with a named config constant (typed via JSDoc or TS type) and export default config across many example and package ESLint flat config files; no semantic rule changes.

Sequence Diagram(s)

sequenceDiagram
  participant DevTool as "ESLint/Runner"
  participant RootConfig as "eslint.config.js"
  participant Jiti as "jiti loader"
  participant OxlintConfig as "oxlint.config.ts"
  participant Oxlint as "oxlint.buildFromOxlintConfig"
  participant ESLintEngine as "Final ESLint config"

  DevTool->>RootConfig: Load config (runtime)
  RootConfig->>Jiti: require('./oxlint.config.ts')\nvia jiti(import.meta.url)
  Jiti->>OxlintConfig: compile & return default export
  OxlintConfig->>Oxlint: pass config to buildFromOxlintConfig(...)
  Oxlint-->>RootConfig: return oxlint rule configs
  RootConfig->>ESLintEngine: append oxlint rules,\nmerge plugins & linterOptions
  ESLintEngine-->>DevTool: run lint with final config

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 I hopped through configs, neat and bright,
Jiti fetched oxlint late at night,
Rules aligned in a tidy row,
Warnings whisper, errors glow,
A tiny rabbit's linting delight ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately summarizes the main change: adding oxlint as a pre-linting pass before ESLint in CI.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description is comprehensive and follows the template structure with clear sections on changes, checklist items, and release impact.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}