ultracite 7.7.0 → 7.8.1

package/README.md

@@ -2,7 +2,7 @@
 
 **A production-grade, zero-configuration preset for ESLint, Biome, and Oxlint.**
 
-Ultracite is designed to help you and your AI models write consistent and type-safe code without the hassle of configuration. Choose your preferred toolchain and get started in seconds.
+Ultracite helps you and your AI models write consistent, type-safe code without the hassle of configuration. Pick your preferred toolchain, run one command, and get hundreds of battle-tested rules wired up in seconds — across single repos and monorepos alike.
 
 <div>
   <img src="https://img.shields.io/npm/dy/ultracite" alt="" />
@@ -16,33 +16,73 @@ Ultracite is designed to help you and your AI models write consistent and type-s
 npx ultracite init
 ```
 
-The interactive setup will guide you through selecting your formatter/linter, framework, editor, and AI agents.
-It can also offer to install the reusable Ultracite skill, or you can pass `--install-skill` in non-interactive flows.
+The interactive setup guides you through choosing your formatter/linter, framework, editor, and AI agents, then installs and configures everything for you. Re-run it any time to adjust your setup.
+
+> Prefer a different package manager? Ultracite detects yours automatically, or you can run it with `pnpm dlx`, `yarn dlx`, or `bunx`.
+
+## Commands
+
+| Command                      | Description                                                                              |
+| ---------------------------- | ---------------------------------------------------------------------------------------- |
+| `ultracite init`             | Initialize Ultracite in the current directory (interactive by default).                  |
+| `ultracite check [files...]` | Lint without writing changes. Unknown flags are passed through to the underlying linter. |
+| `ultracite fix [files...]`   | Lint and auto-fix. Unknown flags are passed through to the underlying linter.            |
+| `ultracite doctor`           | Verify your Ultracite setup and diagnose configuration issues.                           |
+
+`check` and `fix` accept an optional list of files or globs; omit them to run against the whole project. Add `-v` / `--version` or `-h` / `--help` for CLI details.
+
+Common `init` flags for non-interactive / CI use:
+
+| Flag                           | Description                                                         |
+| ------------------------------ | ------------------------------------------------------------------- |
+| `--linter <linter>`            | Toolchain to configure (Biome, ESLint, or Oxlint).                  |
+| `--pm <pm>`                    | Package manager to use.                                             |
+| `--editors <editors...>`       | Editors to configure (use `universal` for `.vscode/settings.json`). |
+| `--agents <agents...>`         | AI agents to enable (use `universal` for `AGENTS.md`).              |
+| `--frameworks <frameworks...>` | Frameworks in use, for framework-aware rules.                       |
+| `--type-aware`                 | Enable type-aware linting.                                          |
+| `--install-skill`              | Install the reusable Ultracite skill after setup.                   |
+| `--skip-install`               | Configure without installing dependencies.                          |
+| `--quiet`                      | Suppress interactive prompts (auto-enabled in CI).                  |
+
+See the [CLI reference](https://docs.ultracite.ai/) for the full, current list of options.
 
 ## Supported Tools
 
-- **Biome** — All-in-one formatting and linting
-- **ESLint + Prettier + Stylelint** — Most mature ecosystem with the largest plugin support
-- **Oxlint + Oxfmt** — 50-100x faster than ESLint, part of the Oxc ecosystem
+- **Biome** — All-in-one formatting and linting in a single fast binary.
+- **ESLint + Prettier + Stylelint** — The most mature ecosystem with the largest plugin support.
+- **Oxlint + Oxfmt** — Rust-based tooling that runs dramatically faster than ESLint, part of the Oxc ecosystem.
 
 ## Key Features
 
 ### ⚡ Subsecond Performance
 
-Built on Rust-based tools for instant code analysis. On-save checks feel seamless without interrupting your workflow.
+Built around Rust-based tooling for near-instant analysis. On-save checks feel seamless and stay out of your way.
 
 ### 🎯 Zero-Config by Design
 
-Hundreds of preconfigured rules optimized for JavaScript and TypeScript projects. Customize when needed, but it works perfectly out of the box.
+Hundreds of preconfigured rules tuned for modern JavaScript and TypeScript. It works out of the box, and you can override anything when you need to.
 
 ### 🤖 AI-Ready
 
-Generate rules for 40+ AI agents including Claude Code, GitHub Copilot, Cursor, Gemini, and more. Ensures consistent code style across all team members and AI models.
+Generate ruleset and context files for a wide range of AI agents — Claude Code, GitHub Copilot, Cursor, Gemini, and many more — so humans and models share one consistent style.
 
 ### 🏗️ Monorepo Ready
 
-Unified toolchain configuration across all packages and apps, eliminating duplicate config files while maintaining consistency.
+One unified toolchain configuration across every package and app, eliminating duplicate config files while keeping standards consistent.
+
+## Using the presets directly
+
+Beyond the CLI, Ultracite publishes ready-made config presets you can extend in your own setup (Biome, ESLint, Oxlint, Oxfmt, Prettier, and Stylelint). `ultracite init` wires these up for you; if you'd rather reference them by hand, the [configuration docs](https://docs.ultracite.ai/) list the exact import paths and extension points for each toolchain.
+
+## Documentation
+
+Full setup guides, configuration options, rule references, framework and editor integrations, and examples live in the docs:
+
+- **Docs:** https://docs.ultracite.ai/
+- **Website:** https://www.ultracite.ai/
+- **Issues & discussions:** https://github.com/haydenbleasel/ultracite
 
----
+## License
 
-Read the [docs](https://docs.ultracite.ai/) for detailed setup instructions, configuration options, and examples.
+MIT © [Hayden Bleasel](https://github.com/haydenbleasel)

package/config/biome/tanstack/biome.jsonc

@@ -0,0 +1,16 @@
+{
+	"root": false,
+	"$schema": "../../../node_modules/@biomejs/biome/configuration_schema.json",
+	"overrides": [
+		{
+			"includes": ["**/routes/**/*.{tsx,ts}", "**/app/routes/**/*.{tsx,ts}"],
+			"linter": {
+				"rules": {
+					"style": {
+						"useFilenamingConvention": "off"
+					}
+				}
+			}
+		}
+	]
+}

package/config/eslint/react/eslint.config.mjs

@@ -1,12 +1,10 @@
 /* eslint-disable n/no-unpublished-import, n/no-extraneous-import, import/no-extraneous-dependencies, id-length */
 
-import query from "@tanstack/eslint-plugin-query";
 import jsxA11y from "eslint-plugin-jsx-a11y";
 import react from "eslint-plugin-react";
 import reactHooks from "eslint-plugin-react-hooks";
 
 import jsxA11yRules from "./rules/jsx-a11y.mjs";
-import queryRules from "./rules/query.mjs";
 import reactHooksRules from "./rules/react-hooks.mjs";
 import reactRules from "./rules/react.mjs";
 
@@ -21,7 +19,6 @@ const config = [
       },
     },
     plugins: {
-      "@tanstack/query": query,
       "jsx-a11y": jsxA11y,
       react,
       "react-hooks": reactHooks,
@@ -30,7 +27,6 @@ const config = [
       ...reactRules,
       ...reactHooksRules,
       ...jsxA11yRules,
-      ...queryRules,
     },
     settings: {
       react: {

package/config/eslint/tanstack/eslint.config.mjs

@@ -0,0 +1,34 @@
+/* eslint-disable n/no-unpublished-import, n/no-extraneous-import, import/no-extraneous-dependencies, id-length */
+
+import query from "@tanstack/eslint-plugin-query";
+import router from "@tanstack/eslint-plugin-router";
+import start from "@tanstack/eslint-plugin-start";
+
+import queryRules from "./rules/query.mjs";
+import routerRules from "./rules/router.mjs";
+import startRules from "./rules/start.mjs";
+
+const config = [
+  {
+    files: ["**/*.jsx", "**/*.tsx"],
+    languageOptions: {
+      parserOptions: {
+        ecmaFeatures: {
+          jsx: true,
+        },
+      },
+    },
+    plugins: {
+      "@tanstack/query": query,
+      "@tanstack/router": router,
+      "@tanstack/start": start,
+    },
+    rules: {
+      ...queryRules,
+      ...routerRules,
+      ...startRules,
+    },
+  },
+];
+
+export default config;

package/config/eslint/tanstack/rules/router.mjs

@@ -0,0 +1,13 @@
+import pluginRouter from "@tanstack/eslint-plugin-router";
+
+const { rules } = pluginRouter;
+
+const availableKeys = Object.keys(rules).filter(
+  (key) => !rules[key]?.meta?.deprecated
+);
+
+const baseRules = Object.fromEntries(
+  availableKeys.map((key) => [`@tanstack/router/${key}`, "error"])
+);
+
+export default { ...baseRules };

package/config/eslint/tanstack/rules/start.mjs

@@ -0,0 +1,13 @@
+import pluginStart from "@tanstack/eslint-plugin-start";
+
+const { rules } = pluginStart;
+
+const availableKeys = Object.keys(rules).filter(
+  (key) => !rules[key]?.meta?.deprecated
+);
+
+const baseRules = Object.fromEntries(
+  availableKeys.map((key) => [`@tanstack/start/${key}`, "error"])
+);
+
+export default { ...baseRules };

package/config/oxlint/core/index.mjs

@@ -61,6 +61,7 @@ export default defineConfig({
     "grouped-accessor-pairs": "error",
     "guard-for-in": "error",
     "id-length": "off",
+    "id-match": "error",
     "init-declarations": "off",
     "logical-assignment-operators": "error",
     "max-classes-per-file": "error",
@@ -113,6 +114,8 @@ export default defineConfig({
     "no-func-assign": "error",
     "no-global-assign": "error",
     "no-implicit-coercion": "off",
+    "no-implicit-globals": "error",
+    "no-implied-eval": "error",
     "no-import-assign": "error",
     "no-inline-comments": "error",
     "no-inner-declarations": "error",
@@ -192,6 +195,7 @@ export default defineConfig({
     "no-with": "error",
     "object-shorthand": "error",
     "operator-assignment": "error",
+    "prefer-arrow-callback": "error",
     "prefer-const": "error",
     "prefer-destructuring": "error",
     "prefer-exponentiation-operator": "error",
@@ -199,6 +203,7 @@ export default defineConfig({
     "prefer-object-has-own": "error",
     "prefer-object-spread": "error",
     "prefer-promise-reject-errors": "error",
+    "prefer-regex-literals": "error",
     "prefer-rest-params": "error",
     "prefer-spread": "error",
     "prefer-template": "error",
@@ -227,6 +232,7 @@ export default defineConfig({
     "import/group-exports": "off",
     "import/max-dependencies": "off",
     "import/namespace": "error",
+    "import/newline-after-import": "error",
     "import/no-absolute-path": "error",
     "import/no-amd": "error",
     "import/no-anonymous-default-export": "off",
@@ -268,7 +274,10 @@ export default defineConfig({
     "jsdoc/require-returns": "off",
     "jsdoc/require-returns-description": "error",
     "jsdoc/require-returns-type": "off",
+    "jsdoc/require-throws-description": "error",
+    "jsdoc/require-throws-type": "error",
     "jsdoc/require-yields": "error",
+    "jsdoc/require-yields-type": "error",
 
     // ── node ───────────────────────────────────────────────────────────
     "node/global-require": "error",

package/config/oxlint/react/index.mjs

@@ -3,8 +3,12 @@ import { defineConfig } from "oxlint";
 export default defineConfig({
   plugins: ["react", "react-perf", "jsx-a11y"],
   rules: {
+    "jsx-a11y/control-has-associated-label": "error",
     "jsx-a11y/interactive-supports-focus": "error",
     "jsx-a11y/no-autofocus": "off",
+    "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",
     "react-perf/jsx-no-jsx-as-prop": "off",
     "react-perf/jsx-no-new-array-as-prop": "off",
     "react-perf/jsx-no-new-object-as-prop": "off",
@@ -15,7 +19,9 @@ export default defineConfig({
     "react/jsx-props-no-spreading": "off",
 
     "react/no-multi-comp": "off",
+    "react/no-object-type-as-default-prop": "error",
     "react/no-unknown-property": "off",
+    "react/no-unstable-nested-components": "error",
     "react/only-export-components": "off",
 
     "react/react-in-jsx-scope": "off",

package/config/oxlint/tanstack/index.d.mts

@@ -0,0 +1,5 @@
+import type { OxlintConfig } from "oxlint";
+
+declare const config: OxlintConfig;
+
+export default config;

package/config/oxlint/tanstack/index.mjs

@@ -0,0 +1,20 @@
+import { defineConfig } from "oxlint";
+
+export default defineConfig({
+  overrides: [
+    {
+      files: ["**/routes/**/*.{tsx,ts}", "**/app/routes/**/*.{tsx,ts}"],
+      rules: {
+        "unicorn/filename-case": "off",
+      },
+    },
+    {
+      files: ["**/routeTree.gen.ts"],
+      rules: {
+        "unicorn/filename-case": "off",
+        "unicorn/no-abusive-eslint-disable": "off",
+      },
+    },
+  ],
+  rules: {},
+});

package/config/oxlint/vitest/index.mjs

@@ -34,6 +34,7 @@ export default defineConfig({
         "vitest/no-test-prefixes": "error",
         "vitest/no-test-return-statement": "error",
         "vitest/no-unneeded-async-expect-function": "error",
+        "vitest/padding-around-after-all-blocks": "error",
         "vitest/prefer-called-exactly-once-with": "error",
         "vitest/prefer-called-once": "error",
         "vitest/prefer-called-with": "error",