oxlint-plugin-arch 0.11.0 → 0.12.1

package/CHANGELOG.md

@@ -1,5 +1,246 @@
 # Changelog
 
+## 0.12.1
+
+### Changed
+
+- Preset: tests live in a `tests/` (or `test/`) folder. A `*.test.*` or `*.spec.*` file inside a unit's source is reported by `arch/files-restricted`.
+
+### Fixed
+
+- Preset detection reads `pnpm-workspace.yaml` (block or flow lists), workspace globs with `*` anywhere, `**`, `{a,b}` and `!exclude`, and peer dependencies (a UI package with React as a peer is `ui`). Packages and service domains named like output folders (`build`, `public`) are no longer skipped.
+- Preset detection keeps a root app's or backend's recipe next to its workspace packages (when the root has its own source folder), gives a single root package its recipe (`library` included), and keeps the root unit next to a detected `scripts/` CLI. A folder with its own `package.json` is a unit with its own kind, also when nested in another workspace or listed through a `*` key, instead of inheriting the root app's kind.
+- Preset: a unit without `src/` uses its own folder as source (a workspace Next app with `app/` at the package root).
+- Preset detection honors a configured `source`, `backend.registry` file or `false`, expands `*` keys (with exact keys beside them, which also inherit the wildcard's `source`) before adding conventions, and understands import maps such as `"#/*": "./src/*.ts"`, `"#/*.ts": "./src/*.ts"`, exact and conditional entries.
+- Preset detection: a service may import its own domain's operations; other domains stay banned through one `!(domain)` pattern per domain, and a ban you configure yourself is never lifted. A web app's or package's own aliases that overlap the backend's (`#/*`, `#/lib/*`) are no longer banned.
+- Preset detection skips broken symlinks, follows symlinked folders, and drops conventions inside a `false` folder or for a group a parent sets to `false` (an exact key beats a `*` key at the same depth, and an exact key that revives a unit under a `false` wildcard keeps its conventions), instead of throwing.
+- Preset: folder keys accept dots (`packages/my.lib`, `.agents`), and `apps/web/` or `./apps` match the detected `apps/web` and `apps`.
+- Preset: nested group options merge with the inherited ones (`tests.mocking: { allow: [] }` keeps the parent's `preset` and `deny`, also when the parent used the `'strict'` shorthand).
+- Preset: the registry file is exempt from the domain layout and its file and folder name checks; test files skip the domain, operation and frontend runtime file name checks (the `tests/` check below reports them once); operation files in `actions/` and `queries/` keep the single-export check; `layout.strict` accepts `.rsc.tsx`.
+- Preset: Tailwind stylesheet detection ignores comments, strings and plugins such as `tailwindcss-animate`, accepts `@import url("tailwindcss")` with or without quotes, and follows symlinked folders.
+- Preset: `dist`, `build`, `coverage` and `.output` are ignored at the project root and at each unit's root, not at any depth, so a `services/build/` domain is linted.
+- `arch/boundaries-deny` import globs accept `!(a|b)`: one path segment that is none of the names.
+- Preset: `layout.strict` checks domain file names at any depth under `services/<domain>/`, so a nested or misnamed file (`order/queries/order-query-list.ts`) is reported for its name, not only its folder. `layout.operations: 'folders'` keeps its own `actions/` and `queries/` names.
+- Preset detection: a `next` or `vinext` dependency wins over a leftover `@tanstack/react-start` one.
+- Preset detection: a package with `services/<domain>/<domain>.service.ts` gets the `backend` recipe without a backend framework dependency.
+- Preset: `services/**/*.rsc.{ts,tsx}` files and frontend operation files (`*-action.*.client.ts` and the other runtime suffixes) keep the export prefix check next to their name pattern or template. Since 0.12.0 the later override replaced it; 0.11 ran both.
+- `dillon-anti-slop/no-shape-in-symbol-names` reports only names you declare: not another API's property (`schema.shape`, `record.shape = 1`), a renamed destructured property or import, a qualified type read, a JSX member or attribute, or a renamed re-export from another module. A shorthand property reports once.
+
+## 0.12.0
+
+### Breaking: rebuilt package
+
+- Every owned rule is now `arch/<family>-<subject>`; the `modules` plugin is gone. Update configs and `oxlint-disable` comments with the table below. Old IDs are not aliased: an old ID in a disable comment no longer suppresses anything.
+- Entry points: `oxlint-plugin-arch` (rules), `oxlint-plugin-arch/preset` (`preset`, `recipes`, `templates`, `PresetError` and the option types) and `oxlint-plugin-arch/dillon-anti-slop`. The `presets/*` and `rules/*` subpaths are removed.
+- Selector rules (`code-switch`, `code-double-negation`, `naming-types`, `types-local-alias`, `react-empty-effect`, `react-dynamic-classes`, `boundaries-rpc-database`, `tests-concurrent-db`) accept an optional `message` option.
+- The preset is `preset({ root, folders })`: folders map to groups, nested folders inherit and refine, recipes and templates hold shared defaults. `reactModulesPreset`, `nextReactModulesPreset`, `tanstackStartReactModulesPreset`, `architecture`, roles, `policies`, `ruleSeverities` and `ruleExclusions` are removed; see the option table below. Expo apps get an `expo` group. `naming-shape` in the preset is replaced by `dillon-anti-slop/no-shape-in-symbol-names`. Invalid folders and options throw `PresetError`.
+- Rule options use one short vocabulary (`allow`, `deny`, `min`, `max`, `message`, ...); see the rule option table below. Old option names are not aliased and fail schema validation. Defaults are unchanged. Rule behavior and messages are otherwise unchanged apart from the fixes under Fixed (two messages that named an option now name the new one); checked by running the 0.11 rule tests against the new rules, and by linting two consumer monorepos with equivalent folder configs.
+- Merged rules: `naming-export-prefix`, `naming-export-pattern` and `naming-export-template` are now `naming-exports`, one check per option object (`mode: 'prefix' | 'pattern' | 'template'`), so several checks can share a file: `['error', { mode: 'prefix' }, { mode: 'pattern', pattern: '^use[A-Z]' }]`. `allDeclarations: true` → `scope: 'declarations'`, `allFunctions: true` → `scope: 'functions'`, `naming-export-template`'s `mode: 'all' | 'some'` → `match`; the other options follow the rule option table. `files-factory` is now `files-exports` with `factory` (its `allDeclarations: true` → `scope: 'declarations'`; `names` is no longer required). `comments-members` is now `comments-code` with `members: 'only'` (`'also'` adds member checks to the normal ones). `naming-shape` is removed; use `dillon-anti-slop/no-shape-in-symbol-names`. `code-switch` now defaults to `'Avoid switch statements.'`. Message IDs and texts are unchanged, apart from the fixes under Fixed.
+- Docs: `docs/folders.md`, one page per group in `docs/groups/`, one page per rule in `docs/rules/`, `docs/vendor.md` and `docs/plugin-only.md`. The README group and rule tables are generated (`bun run docs`).
+- New `arch/copy-dashes`: reports em dashes in strings, template text and JSX text. On in the preset as `style.dashes`.
+- React plugins, `oxlint-tailwindcss` and `@shadcn/lint` are optional peer dependencies, loaded only when a folder turns on their group; a missing one throws `PresetError` with the install command.
+- `bun run bench <repo>` times every rule against a consumer repo and prints the slowest.
+- Architecture checks that needed vitest tests are now lint:
+  - `deny` group (on, empty): per-folder `imports` and `calls` bans, inherited and merged down the tree, via the new `arch/boundaries-deny` (static, re-export and literal dynamic imports).
+  - `externals` group (on): new `arch/files-externals` checks `ssr.external` in `vite.config.*` and `serverExternalPackages` in `next.config.*` against `package.json`; `externals` exports the default must-stay-external list.
+  - `backend.registry`: new `arch/backend-registry`, every `services/<domain>/` has `<domain>.service.ts` and is listed in the registry file. `backend.writes`: methods query files may not call (Kysely writes by default).
+  - `layout.strict` (closed set of domain file roles), `layout.operations: 'folders'` (`actions/` and `queries/` with `make…` factories), `layout.service` (allowed `.service.ts` exports).
+  - `naming.files` and `naming.exports` take a regex for the folder; `naming.unique` keeps a file name part unique per folder (migration numbers), via the new `unique` option of `arch/naming-file`.
+  - `tanstack` keeps `@tanstack/react-start/rsc` in `services/*.rsc.{ts,tsx}`; `expo` checks Expo Router file names and keeps route files free of helpers.
+  - Folder `rules` take `[level, options]` as well as a level.
+
+| Old preset option | New |
+| --- | --- |
+| `tanstackStartReactModulesPreset(...)` | `preset({ root, folders })` |
+| `architecture: { 'apps/web': 'web' }` | `folders: { 'apps/web': recipes.tanstack }` (`recipes.next`, `recipes.expo`) |
+| role `server` / `runner` | `recipes.backend` |
+| role `packages` | `recipes.library` (`'packages/*'` for a folder of packages) |
+| role `scripts`, `cliFiles` | `recipes.cli` on the folder |
+| entry `layout: { services: 'flat' }`, `sourceDir` | folder `layout: { services: 'flat' }`, `source` |
+| `framework` | the `tanstack` / `next` / `expo` group on the folder |
+| `severity` | folder `severity` |
+| `ruleSeverities`, `ruleExclusions` | folder `rules: { 'arch/x': 'warn' \| 'off' }` |
+| `policies: { x: false }` | the group set to `false` on the folder |
+| `ignorePatterns` | the folder set to `false` |
+| `formatting.semi`, `formatting.quotes` | `style.semicolons`, `style.quotes` |
+| `limits.maxFileLines`, `maxTypeFileLines`, `maxFunctionComplexity` | `limits.lines`, `limits.types`, `limits.complexity` |
+| `modules.customFileRoles` | `layout.suffixes` |
+| `modules.migrationFiles` | the migrations folder with `layout: false` |
+| `modules.colocatedTypeFiles` | `types.colocated` |
+| `imports.backendEntryPoints`, `aliases`, `internalSortPatterns` | `backend.exports`, `imports.aliases`, `imports.internal` |
+| `orpc.publicProcedureFiles`, `outputSchemaComposers`, `clientOwnerFile` | `orpc.public`, `orpc.composers`, `orpc.client` |
+| `sql.likeSanitizers`, `forms.schemaResolver` | `sql.sanitizers`, `forms.resolver` |
+| `react.compiler`, `react.componentProps` | `react.compiler`, `react.props` |
+| `tests.profile`, `additionalTestFunctions`, `additionalAssertionFunctions`, `mocking` | `tests.fixtures`, `tests.functions`, `tests.assertions`, `tests.mocking` |
+| `tanstackStart.*` / `next.*` server, client, computed imports | `tanstack` / `next` group `server`, `client`, `dynamic` |
+| `tailwind.cssEntryPoint(sByRoot)`, `rootFontSize` | folder `tailwind.css`, `tailwind.rem` |
+| `shadcn.ui`, `shadcn.components` | `shadcn.ui`, `shadcn.components`; mark UI kit packages with `kit: true` |
+
+| Old ID | New ID |
+| --- | --- |
+| `arch/call-arguments-multiline` | `arch/layout-call-arguments` |
+| `arch/call-array-multiline` | `arch/layout-call-array` |
+| `arch/chain-newline` | `arch/layout-chain` |
+| `arch/component-props` | `arch/react-props` |
+| `arch/declaration-name` | `arch/naming-declarations` |
+| `arch/export-file-prefix` | `arch/naming-exports` |
+| `arch/export-name-pattern` | `arch/naming-exports` (`mode: 'pattern'`) |
+| `arch/filename-export-name` | `arch/naming-exports` (`mode: 'template'`) |
+| `arch/filename-match` | `arch/naming-file` |
+| `arch/folder-prefix` | `arch/naming-folder` |
+| `arch/jsx-attributes-multiline` | `arch/layout-jsx-attributes` |
+| `arch/key-value-same-line` | `arch/layout-key-value` |
+| `arch/no-comments` | `arch/comments-code` |
+| `arch/no-extra-exports` | `arch/files-exports` |
+| `arch/no-extra-factory-keys` | `arch/files-factory-keys` |
+| `arch/no-file-level-helpers` | `arch/files-helpers` |
+| `arch/no-imported-type-alias` | `arch/types-imported-alias` |
+| `arch/no-inline-schema-elements` | `arch/schemas-inline` |
+| `arch/no-inline-types` | `arch/types-inline` |
+| `arch/no-literal-in` | `arch/code-literal-in` |
+| `arch/no-local-schema-construction` | `arch/schemas-local` |
+| `arch/no-member-comments` | `arch/comments-code` (`members: 'only'`) |
+| `arch/no-module-mutable-state` | `arch/code-mutable-state` |
+| `arch/no-promise-all-mutation` | `arch/code-promise-mutation` |
+| `arch/no-rederive-schema` | `arch/schemas-rederive` |
+| `arch/no-restricted-constructor` | `arch/code-constructor` |
+| `arch/no-restricted-files` | `arch/files-restricted` |
+| `arch/no-restricted-token` | `arch/boundaries-token-owner` |
+| `arch/no-runtime-in-types` | `arch/files-types-only` |
+| `arch/no-single-use-scalar-schema` | `arch/schemas-single-use` |
+| `arch/no-top-level-functions` | `arch/files-no-functions` |
+| `arch/no-trivial-functions` | `arch/code-trivial-functions` |
+| `arch/no-type-declarations` | `arch/types-declarations` |
+| `arch/no-unescaped-like` | `arch/backend-sql-like` |
+| `arch/object-multiline` | `arch/layout-object` |
+| `arch/only-export-components` | `arch/files-components-only` |
+| `arch/only-export-constants` | `arch/files-constants-only` |
+| `arch/padding-between-statements` | `arch/layout-padding` |
+| `arch/prefer-namespace-type-import` | `arch/types-namespace-import` |
+| `arch/require-file-factory` | `arch/files-exports` (`factory`) |
+| `arch/require-object-params` | `arch/code-object-params` |
+| `arch/require-orpc-output` | `arch/backend-orpc-output` |
+| `arch/require-paired-call` | `arch/code-paired-call` |
+| `arch/route-surface` | `arch/files-route` |
+| `arch/ternary-layout` | `arch/layout-ternary` |
+| `arch/test-title-pattern` | `arch/tests-titles` |
+| `modules/backend-switch` | `arch/code-switch` |
+| `modules/concurrent-db` | `arch/tests-concurrent-db` |
+| `modules/domain-constants` | `arch/files-domain-constants` |
+| `modules/double-negation` | `arch/code-double-negation` |
+| `modules/dynamic-classes` | `arch/react-dynamic-classes` |
+| `modules/empty-effect` | `arch/react-empty-effect` |
+| `modules/import-boundaries` | `arch/boundaries-imports` |
+| `modules/local-type-alias` | `arch/types-local-alias` |
+| `modules/memoization` | `arch/react-memo` |
+| `modules/next-runtime` | `arch/boundaries-next` |
+| `modules/no-unknown` | `arch/types-unknown` |
+| `modules/pascal-interface` | `arch/naming-types` |
+| `modules/reasoned-directives` | `arch/comments-directives` |
+| `modules/rpc-database` | `arch/boundaries-rpc-database` |
+| `modules/service-functions` | `arch/backend-service-functions` |
+| `modules/service-types` | `arch/types-service` |
+| `modules/shape-suffix` | `dillon-anti-slop/no-shape-in-symbol-names` |
+| `modules/tanstack-runtime` | `arch/boundaries-tanstack` |
+| `modules/test-assertions` | `arch/tests-assertions` |
+| `modules/test-modifiers` | `arch/tests-modifiers` |
+
+| Rule | Old option | New option |
+| --- | --- | --- |
+| `backend-orpc-output` | `handlerMethod`, `outputMethod` | `handler`, `output` |
+| `backend-service-functions` | `allowLocalHelpers`, `allowReturnedMethods`, `singleExport` | `helpers`, `methods`, `single` |
+| `backend-sql-like` | `allowSanitizedBindings`, `operatorMethods` | `bindings`, `operators` |
+| `boundaries-imports` | `fileRoles`, `portableLib`, `publicEntrypoints` | `roles`, `portable`, `entrypoints` |
+| `boundaries-next`, `boundaries-tanstack` | `serverImports`, `clientImports`, `allowComputedImportsIn` | `server`, `client`, `dynamic` |
+| `boundaries-tanstack` | `rpcClients` | `rpc` |
+| `boundaries-token-owner` (and each `restrictions[]` entry) | `allowIn`, `allowPathPatterns` | `allow`, `patterns` |
+| `code-constructor` | `checkCalls` | `calls` |
+| `code-mutable-state` | `allowNamePattern` | `allow` |
+| `code-object-params` | `maxParams`, `allDeclarations`, `serviceMethods`, `allowPattern` | `max`, `all`, `services`, `allow` |
+| `code-promise-mutation` | `checkAssignments` | `assignments` |
+| `code-trivial-functions` | `allowPattern`, `allowCallees`, `allowAsync`, `checkServiceMethods`, `bannedNames`, `checkGenericGuards` | `allow`, `callees`, `async`, `services`, `deny`, `guards` |
+| `comments-code` | `allowWhy`, `allowPatterns`, `allowJsdoc` | `why`, `allow`, `jsdoc` |
+| `files-components-only` | `matchFileName`, `trailingRoles`, `allowTypeExports`, `denyTypePattern` | `filename`, `roles`, `types`, `deny` |
+| `files-constants-only` | `allowFunctionValues`, `allowTypeExports`, `allowReExports` | `functions`, `types`, `reexports` |
+| `files-domain-constants` | `includeData`, `allowServiceMethods` | `data`, `services` |
+| `files-exports` | `domainStem`, `trailingRoles`, `roleSeparators`, `allowTypeExports`, `factoryScope` | `stem`, `roles`, `separators`, `types`, `scope` |
+| `files-factory-keys` (and each `sets[]` entry) | `factoryPattern`, `requireKeys`, `keySets` | `factory`, `required`, `sets` |
+| `files-helpers` | `allowPattern`, `detectComponents`, `hookPattern` | `allow`, `components`, `hooks` |
+| `files-no-functions` | `banReExports`, `allowPattern` | `reexports`, `allow` |
+| `files-route` | `exportName`, `allowedExports`, `inspectExports`, `bannedHooks`, `banIntrinsicJsx` | `export`, `exports`, `inspect`, `hooks`, `intrinsic` |
+| `files-types-only` | `runtimeImports`, `allowImportSources`, `banReExports` | `imports`, `sources`, `reexports` |
+| `layout-call-arguments` | `minArguments` | `min` |
+| `layout-call-array` | `minElements` | `min` |
+| `layout-chain` (`groups[]`) | `minDepth`, `onlyMethods`, `rootPattern` | `min`, `only`, `root` |
+| `layout-jsx-attributes` | `minAttributes` | `min` |
+| `layout-object` | `minProperties` | `min` |
+| `layout-padding` | `returnMinStatements`, `multilineVariables` | `min`, `multiline` |
+| `layout-ternary` | `maxLength` | `max` |
+| `naming-declarations` | `trailingRoles`, `roleSeparators`, `allowPattern` | `roles`, `separators`, `allow` |
+| `naming-exports` | `trailingRoles`, `roleSeparators`, `ignoreTypeExports`, `serviceMethods`, `allowPattern`, `placeholderPattern` | `roles`, `separators`, `types`, `services`, `allow`, `placeholder` |
+| `naming-folder` | `stripPrefixes` | `prefixes` |
+| `react-props` | `filePrefix` | `prefix` |
+| `schemas-inline`, `schemas-single-use` | `structuralMethods`, `allowZodScalars` | `structural`, `scalars` |
+| `schemas-local` | `allowIn`, `allowPathPatterns`, `runtimeImportMessage` | `allow`, `patterns`, `importMessage` |
+| `tests-assertions` | `additionalTestFunctions`, `additionalAssertionFunctions` | `functions`, `assertions` |
+| `tests-modifiers` | `additionalTestFunctions` | `functions` |
+| `tests-titles` | `forbid` | `deny` |
+| `types-declarations` | `allowPattern` | `allow` |
+| `types-inline` | `functionTypes`, `minMembers` | `functions`, `min` |
+
+### Changed
+
+- Preset detection: `preset()` picks each workspace folder's recipe from its `package.json` dependencies, and adds conventions for backend `services/`, `core/`, `rpc/`, `routes/`, `cli/`, `tests/kits/` and `migrations/` folders, web apps and packages. It also detects the Tailwind stylesheet by content (`app.css`, `styles.css`, `globals.css`, ...), the backend registry file, backend entries from `exports`, and flat web services. Your folders merge over the detected ones; `detect: false` turns it off. See `docs/folders.md`.
+- New recipes `react`, `desktop` and `ui`; `kit` stays as an alias of `ui`.
+- A UI kit without its own stylesheet uses the stylesheet of the web app that depends on it, else the first web app's, and no longer throws when there are several web apps.
+- `backend.registry` takes an options object without `file`. A configured `file` skips no service by default.
+- `backend.writes` adds `dispatch` and `send`.
+- `backend-registry` accepts a singular or plural registry key for a service folder (`order` → `orders`, `category` → `categories`).
+- `boundaries-imports`, `boundaries-next` and `boundaries-tanstack` no longer require their root and package options. An omitted `web`, `backend`, `packages`, `backendPackages`, `appPackages`, `entrypoints` or `rpc` defaults to `[]`, and `aliases` to `{}`; configs that set them behave as before.
+- Preset: a key inside a `false` folder, `backend.writes` below a backend folder, a non-object group value (`null`, arrays, numbers), folders that disagree on `tailwind.rem` or `shadcn.ui`/`shadcn.components`, and expo `client`/`dynamic` now throw instead of being ignored.
+- Preset types: `console` and `kit` take `true` or `false`; expo options are `{ server }` (`PresetExpoOptions`).
+
+### Fixed
+
+- `comments-code` (was `no-comments`): member-comment fixes keep member tokens, separating line breaks and blank lines, skip comments a `disable-next-line` targets, and honor `jsdoc` and `allow`. Removing an inline comment between two spaces leaves one space.
+- `layout-chain` skips chains with computed links instead of reporting them forever. `layout-call-arguments` and `layout-object` fixes keep the original trailing-comma presence.
+- `types-namespace-import` reports without an autofix.
+- `backend-registry`: keys come from top-level objects and factory results (or the one named by `object`), string keys count, a domain without `<folder>.service.ts` is reported on the registry file, and a missing `services` folder is no longer a crash.
+- `backend-sql-like`: sanitized bindings resolve by scope, a reassigned top-level binding is not trusted, and every dynamic part of a LIKE value must be sanitized.
+- `boundaries-tanstack`: browser globals inside server callbacks are reported in any file; code under `<T>x` casts and non-`declare` enums or namespaces counts as runtime; global lookups no longer scale quadratically.
+- `boundaries-tanstack`, `boundaries-next`, `boundaries-imports`: library identities are options with today's values as defaults (`serverPackages`, `clientPackages`, `hookPackages`, `startPackages`, `rscPackages`, `uiPackages`, `publicEnv`); subpaths of server-only and client-only packages match.
+- `boundaries-imports`: `export { type X } from` counts as type-only. `boundaries-deny` and `boundaries-rpc-database` match literal computed callees (`console['log']()`), and `boundaries-rpc-database` no longer matches `db[name]()`.
+- `files-externals`: subpath externals (`pg/native`) check their package; a list with spreads skips the missing-package check; a malformed nearest `package.json` skips the rule.
+- `files-components-only` splits file names only on `-` and `.` again (`user_card.tsx` → `User_card`). `naming-exports` pattern mode treats an empty pattern as match-all again.
+- `naming-file` takes several option objects; `unique` counts only sibling files its object's `pattern` accepts.
+- `files-no-functions`, `code-object-params` and `code-trivial-functions` check `export default` function expressions; `code-object-params` checks a defaulted parameter by its type. `files-no-functions` no longer reports type-only re-exports. `files-exports` checks an aliased export (`export { local as useInvoiceQuery }`) by its exported name. `schemas-inline` names the namespace actually called.
+- Preset: a folder's `naming.files` and `naming.unique` add to the built-in file checks instead of replacing them; invalid `naming` regexes and `layout.operations` below an app or package folder throw `PresetError`; `backend.registry` works for a root-level backend and takes `object`.
+- `bun run bench` resolves plugins from the consumer's config.
+- `boundaries-tanstack` reports static server imports used inside explicit client callbacks even in `.server.ts` files.
+- `layout-call-arguments` reports incorrect layouts with comments or unsafe argument ranges without offering an autofix.
+- `comments-code` removes horizontal padding around inline comments after opening parentheses, producing `foo(1)` from `foo(/* note */ 1)`.
+- Export-name rules (`naming-exports`, `files-exports` and others) read every name in a destructured export (`export const { a, b } = source`) instead of reporting `<anonymous>`.
+- `files-exports` factory mode checks an aliased export by its exported name, and reports aliased exports at the export specifier.
+- `files-no-functions` also allows `export type * from` and `export { type A } from`.
+- `files-factory-keys` checks returned objects wrapped in `as const`, `satisfies` or `!`.
+- `bun run bench` shows Oxlint startup errors, works when no JS rule ran, removes its temp files and resolves symlinked repo paths.
+- `bun run build` clears `dist/` first, so local packs no longer ship stale modules.
+- Preset: when `'.'` is an app, backend or CLI it stays a unit; a top-level key becomes its own unit only when it sets `tanstack`, `next`, `expo`, `backend` or `console`, and a `console` key beside a root app is a CLI rather than an inherited app.
+- Preset: `imports.aliases` and `imports.internal` apply to the folder that sets them; two apps with their own `@/` alias no longer share the last one (`arch/boundaries-imports`, `arch/boundaries-tanstack`, `arch/boundaries-next`, import sorting).
+- Preset: a folder `severity` now also sets the level of the common rules in that folder, and `no-console` inherits `severity` from parent folders.
+- Preset: an exact key beside a `false` `*` key (`'packages/*': false, 'packages/ui': {...}`) is linted instead of ignored.
+- Preset: a `naming.files` pattern in a folder adds to the `layout.strict` domain file check instead of replacing it.
+- Preset: `root` resolves through symlinks, so absolute option paths match the file paths Oxlint reports.
+- `tests-assertions` finds the test callback before a trailing timeout or after an options object, so `test('x', () => {}, 1000)` is reported and its assertions are no longer flagged as standalone.
+- `tests-assertions` no longer follows a helper binding that is reassigned after its declaration.
+- `tests-assertions` tracks renamed `test`, `it` and assertion imports from `bun:test`.
+- `tests-concurrent-db` only reports `db` destructured from the `test.concurrent` callback's context (its parameter, or the parameter destructured in the body), not unrelated local `db` patterns or nested callbacks.
+- `tests-modifiers` reports `.only`, `.skip` and `.todo` after `skipIf()`, `runIf()` and `if()` builders.
+- `types-imported-alias` ignores an alias whose target is its own type parameter (`type Identity<T> = T`), and no longer resolves `export { X } from './other'` against a local alias named `X`.
+- `react-memo` resolves the member root binding, so a local or parameter named `React` no longer counts as React.
+- `dillon-anti-slop/no-widen-then-assert` resolves identifiers through their scope instead of scanning every scope's references, removing quadratic work on files with many assertions.
+- `naming-exports` template mode checks an aliased export (`export { create as makeReportActionCreate }`) by its exported name.
+
 ## 0.11.0
 
 - `modules/no-unknown` allows `unknown` on the narrowed parameter of a type guard (`function isAppError(error: unknown): error is AppError`) and on the error parameter of a catch callback (`catch: (error: unknown) => E`, `.catch((error: unknown) => …)`). Other uses still fail. This applies to every root.

package/README.md

@@ -1,251 +1,85 @@
 # 🏛️ oxlint-plugin-arch
 
-> Architecture rules for [Oxlint](https://oxc.rs), driven by filenames and fully configurable.
+> Architecture rules for [Oxlint](https://oxc.rs): files in the right folders, exports named after their file, types where they belong.
 
-Keep a codebase shaped the way you designed it: files in the right folders, exports named after their file, types where they belong, and no shortcuts across boundaries. Every rule is generic, so **you** decide the paths, names, and policy in your own Oxlint config.
+Linters catch bugs; this catches drift. Describe your folders once, and the preset wires the right rules into each one: apps, backends, libraries, UI kits and scripts. Relax a folder by changing one key, not by writing overrides.
 
-- 🗂️ **Filename-aware.** Rules derive expected names from the file they run on (`user-action.create.ts` → `makeUserActionCreate`).
-- 🎛️ **Configurable.** No app names, folders, or libraries are baked in. Globs and policy live in your config.
-- 🛟 **Safe autofix.** Layout and comment rules touch whitespace or comments; `object-multiline` and `call-arguments-multiline` can also add trailing commas. Type-import fixes qualify scope-resolved references and skip unsafe rewrites.
-- ⚡ **Fast.** Built on Oxlint's JS plugin API and ESTree, with no extra parser.
+## ✨ Features
 
-## Two ways to use it
+- 🗂️ **Folders, not flags.** Each folder says what it holds (`react`, `tanstack`, `backend`, `kit`); nested folders inherit and refine.
+- 🏷️ **Filename-aware.** Rules derive names from the file they run on: `user-action.create.ts` must export `userActionCreate`.
+- 🎛️ **Configurable.** No app names or paths baked in. Every rule works on its own too.
+- 🛟 **Safe autofix.** 🔧 rules only touch whitespace or comments.
+- ⚡ **Fast.** Oxlint's JS plugin API, no extra parser.
 
-| | You get | Start here |
-| --- | --- | --- |
-| **Preset** | A ready policy for React apps with a typed backend (TanStack Start, Next.js, or both). Folders map to roles; every rule is already wired. | [Preset docs](docs/preset/README.md) |
-| **Rules only** | 46 generic `arch/*` rules. You pick rules, globs and options in your own config. | [Install](#-install) |
+## 🧰 Built with
+
+[Oxlint](https://oxc.rs) · [oxlint-tsgolint](https://github.com/oxc-project/tsgolint) · [Bun](https://bun.sh) · TypeScript
+
+## 🚀 Install in 3 steps
 
-## 🚀 Preset in 30 seconds
+**You need:** Oxlint 1.85 or newer.
+
+**1. Install**
 
 ```sh
 bun add -d oxlint oxlint-tsgolint oxlint-plugin-arch
+# React, Tailwind and shadcn groups (the tanstack, next, expo, react and ui recipes):
+bun add -d eslint-plugin-react eslint-plugin-react-you-might-not-need-an-effect eslint-plugin-svg-jsx oxlint-tailwindcss @shadcn/lint
 ```
 
+**2. Add the preset**
+
 ```ts
 // oxlint.config.ts
-import preset from 'oxlint-plugin-arch/presets/tanstack-start-react-modules-preset';
+import { preset } from 'oxlint-plugin-arch/preset'
 
 export default preset({
   root: import.meta.dirname,
-  architecture: {
-    'apps/web': 'web',
-    'apps/server': 'server',
-    scripts: 'scripts',
-    packages: 'packages',
+  folders: {
+    'packages/ui': { react: { a11y: false } },
   },
-});
-```
-
-For a Next.js app use `oxlint-plugin-arch/presets/next-react-modules-preset`. See [architecture](docs/preset/architecture.md), [frameworks](docs/preset/frameworks.md) and [options](docs/preset/options.md).
-
-## 📦 Install
-
-```bash
-bun add -d oxlint-plugin-arch oxlint @oxlint/plugins
+})
 ```
 
-> [!NOTE]
-> Keep `oxlint` and `@oxlint/plugins` on matching versions.
+The preset detects each workspace from its `package.json` (TanStack, Next, Expo, backend, UI kit, library) along with its stylesheet, service registry and migrations. List only the folders you want to change. Detection, inheritance, groups, recipes and templates: [docs/folders.md](docs/folders.md). Rules without the preset: [docs/plugin-only.md](docs/plugin-only.md).
 
-Register the plugin in `oxlint.config.ts`:
+**3. Lint**
 
-```ts
-import { defineConfig } from 'oxlint'
-
-export default defineConfig({
-  jsPlugins: [
-    { name: 'arch', specifier: 'oxlint-plugin-arch' },
-  ],
-})
+```sh
+bunx oxlint
 ```
 
-Then turn rules on per folder with `overrides`:
+## 📚 Groups and rules
 
-```ts
-export default defineConfig({
-  jsPlugins: [{ name: 'arch', specifier: 'oxlint-plugin-arch' }],
-  rules: {
-    'arch/no-literal-in': 'error',
-  },
-  overrides: [
-    {
-      files: ['**/src/components/**/*.tsx'],
-      rules: {
-        'arch/only-export-components': ['error', { matchFileName: true }],
-      },
-    },
-    {
-      files: ['**/*.test.ts'],
-      rules: {
-        'arch/test-title-pattern': ['error', { forbid: '^should\\b', flags: 'i' }],
-      },
-    },
-  ],
-})
-```
+<!-- generated:start -->
+On by default: [`layout`](docs/groups/layout.md), [`limits`](docs/groups/limits.md), [`style`](docs/groups/style.md), [`basics`](docs/groups/basics.md), [`naming`](docs/groups/naming.md), [`comments`](docs/groups/comments.md), [`types`](docs/groups/types.md), [`imports`](docs/groups/imports.md), [`tests`](docs/groups/tests.md), [`deny`](docs/groups/deny.md), [`externals`](docs/groups/externals.md).
 
-To also use the `modules/*` and `dillon-anti-slop/*` rule sets without the preset, see [using the plugins without the preset](docs/plugins.md).
+Opt-in: [`react`](docs/groups/react.md), [`tanstack`](docs/groups/tanstack.md), [`next`](docs/groups/next.md), [`expo`](docs/groups/expo.md), [`tailwind`](docs/groups/tailwind.md), [`shadcn`](docs/groups/shadcn.md), [`kit`](docs/groups/kit.md), [`backend`](docs/groups/backend.md), [`orpc`](docs/groups/orpc.md), [`schemas`](docs/groups/schemas.md), [`forms`](docs/groups/forms.md), [`sql`](docs/groups/sql.md), [`console`](docs/groups/console.md).
 
-## 📚 Examples
+65 rules, IDs `arch/<rule>`. 🔧 = autofix.
 
-| File | Use it when |
-| --- | --- |
-| [`minimal.oxlint.config.ts`](examples/minimal.oxlint.config.ts) | You want the smallest possible starting point. |
-| [`monorepo.oxlint.config.ts`](examples/monorepo.oxlint.config.ts) | ⭐ You are starting an `apps/server` + `apps/web` monorepo and want a strict, copy-ready setup. |
-| [`full.oxlint.config.ts`](examples/full.oxlint.config.ts) | You want to see every `arch/*` rule with its options. |
-| [`preset.oxlint.config.ts`](examples/preset.oxlint.config.ts) | You use the TanStack Start preset with layouts, migrations and a policy callback. |
-| [`mixed-frameworks.oxlint.config.ts`](examples/mixed-frameworks.oxlint.config.ts) | You use the generic preset with Next.js App Router and TanStack Start web roots in one config. |
-
-> [!TIP]
-> `monorepo.oxlint.config.ts` and the preset examples already load `oxlint-plugin-arch`, so you can copy them as-is. `minimal` and `full` load `../src/index.ts`; change that specifier to `oxlint-plugin-arch` when you copy them.
-
-## 🧩 Rules
-
-🔧 means the rule can autofix. Each rule links to its page with examples and options.
-
-Options that take one regex string (`pattern`, `allowPattern`, `forbid`, `require`, and the other `*Pattern` options) also take a non-empty list; any pattern in the list may match. Options that were already lists, such as `allowPatterns` and `allowCallees`, are unchanged.
-
-### `arch/*`
-
-#### 📁 Files & folders
-
-| Rule | What it enforces |
-| --- | --- |
-| [`filename-match`](docs/rules/arch/filename-match.md) | Filenames match a pattern you configure. |
-| [`folder-prefix`](docs/rules/arch/folder-prefix.md) | Filenames start with their parent folder name, or the folders after a root you choose. |
-| [`no-restricted-files`](docs/rules/arch/no-restricted-files.md) | Files matching a glob you forbid are reported, for example misplaced `*.types.ts`. |
-
-#### 🏷️ Naming & exports
-
-| Rule | What it enforces |
-| --- | --- |
-| [`declaration-name`](docs/rules/arch/declaration-name.md) | Selected declarations start with a prefix taken from the filename, or match a pattern. |
-| [`export-file-prefix`](docs/rules/arch/export-file-prefix.md) | Names start with the filename prefix. |
-| [`export-name-pattern`](docs/rules/arch/export-name-pattern.md) | Export names (or every function and type) match a regular expression. |
-| [`filename-export-name`](docs/rules/arch/filename-export-name.md) | Function names follow a template built from the filename. |
-| [`no-extra-exports`](docs/rules/arch/no-extra-exports.md) | A file exports only the names you allow. |
-| [`only-export-constants`](docs/rules/arch/only-export-constants.md) | Constant files export only local `const` values. |
-
-#### 🏭 Functions & factories
-
-| Rule | What it enforces |
-| --- | --- |
-| [`require-file-factory`](docs/rules/arch/require-file-factory.md) | The file defines the factory function its filename promises. |
-| [`no-extra-factory-keys`](docs/rules/arch/no-extra-factory-keys.md) | A factory returns only the keys you allow. |
-| [`require-object-params`](docs/rules/arch/require-object-params.md) | Functions take object parameters instead of long positional lists. |
-| [`no-file-level-helpers`](docs/rules/arch/no-file-level-helpers.md) | No stray helper functions at module scope. |
-| [`no-top-level-functions`](docs/rules/arch/no-top-level-functions.md) | No top-level functions (and optionally no re-exports) in matched files. |
-| [`no-trivial-functions`](docs/rules/arch/no-trivial-functions.md) | No empty or pass-through functions. |
-| [`no-module-mutable-state`](docs/rules/arch/no-module-mutable-state.md) | No module-level `let`/`var`, which is shared across requests and tests. |
-
-#### 🔷 Types
-
-| Rule | What it enforces |
-| --- | --- |
-| [`no-inline-types`](docs/rules/arch/no-inline-types.md) | Function signatures use named types instead of inline `{ ... }` objects. |
-| [`no-type-declarations`](docs/rules/arch/no-type-declarations.md) | No type aliases or interfaces in matched files, so types live in one place. |
-| [`no-runtime-in-types`](docs/rules/arch/no-runtime-in-types.md) | Type modules stay free of runtime code. |
-| [`no-imported-type-alias`](docs/rules/arch/no-imported-type-alias.md) | No exported aliases that only rename an imported type. |
-| [`prefer-namespace-type-import`](docs/rules/arch/prefer-namespace-type-import.md) 🔧 | Long type-only named imports become a namespace import with qualified references. |
-
-#### 🧪 Schemas & APIs
-
-| Rule | What it enforces |
-| --- | --- |
-| [`no-local-schema-construction`](docs/rules/arch/no-local-schema-construction.md) | No schemas built outside the files that own them. |
-| [`no-inline-schema-elements`](docs/rules/arch/no-inline-schema-elements.md) | Named schemas inside combinators like `z.array(...)`. |
-| [`no-rederive-schema`](docs/rules/arch/no-rederive-schema.md) | No re-deriving types from schemas imported from elsewhere. |
-| [`no-single-use-scalar-schema`](docs/rules/arch/no-single-use-scalar-schema.md) | Reports scalar Zod aliases that are used only once. |
-| [`require-orpc-output`](docs/rules/arch/require-orpc-output.md) | oRPC procedures declare a named `.output()` schema. |
-| [`no-unescaped-like`](docs/rules/arch/no-unescaped-like.md) | `LIKE` / `ILIKE` values pass through your sanitizer. |
-
-#### 🚧 Boundaries & safety
-
-| Rule | What it enforces |
-| --- | --- |
-| [`no-restricted-token`](docs/rules/arch/no-restricted-token.md) | Identifiers or member calls appear only in owner files. |
-| [`no-restricted-constructor`](docs/rules/arch/no-restricted-constructor.md) | No `new Error()` (or any constructor you list) where typed errors are required. |
-| [`require-paired-call`](docs/rules/arch/require-paired-call.md) | Calling one function requires calling another, for example `useForm` with a schema resolver. |
-| [`no-promise-all-mutation`](docs/rules/arch/no-promise-all-mutation.md) | No `results.push(...)` or `total += x` on outer variables inside `Promise.all`. Return values instead. |
-| [`no-literal-in`](docs/rules/arch/no-literal-in.md) | No `'key' in value`. Use `Object.hasOwn()` or a discriminated union. |
-
-#### ⚛️ React
-
-| Rule | What it enforces |
-| --- | --- |
-| [`component-props`](docs/rules/arch/component-props.md) | Components type props with `interface XProps` declared directly above them. |
-| [`only-export-components`](docs/rules/arch/only-export-components.md) | Component files export only components, named after the file. |
-| [`route-surface`](docs/rules/arch/route-surface.md) | Route files export only the route, with no banned hooks or raw JSX. |
-
-#### 💬 Comments & tests
-
-| Rule | What it enforces |
-| --- | --- |
-| [`no-comments`](docs/rules/arch/no-comments.md) 🔧 | No comments in matched files, except directives and `Why:` notes. |
-| [`no-member-comments`](docs/rules/arch/no-member-comments.md) 🔧 | No comments on interface, type, and object members. |
-| [`test-title-pattern`](docs/rules/arch/test-title-pattern.md) | Test titles match your rules, for example no leading "should". |
-
-#### 🎨 Layout
-
-| Rule | What it enforces |
-| --- | --- |
-| [`padding-between-statements`](docs/rules/arch/padding-between-statements.md) 🔧 | Blank lines around functions, classes, control flow and late returns. |
-| [`object-multiline`](docs/rules/arch/object-multiline.md) 🔧 | Objects with 3+ properties passed to a call go one property per line. |
-| [`ternary-layout`](docs/rules/arch/ternary-layout.md) 🔧 | Join short conditionals or split long ones before `?` and `:`. |
-| [`call-arguments-multiline`](docs/rules/arch/call-arguments-multiline.md) 🔧 | Calls and constructors with 3+ arguments go one argument per line. |
-| [`key-value-same-line`](docs/rules/arch/key-value-same-line.md) 🔧 | An object key and the start of its value stay on the same line. |
-| [`chain-newline`](docs/rules/arch/chain-newline.md) 🔧 | Long method chains go one call per line. |
-| [`call-array-multiline`](docs/rules/arch/call-array-multiline.md) 🔧 | Arrays passed to `Promise.all` (or callees you list) go one element per line. |
-| [`jsx-attributes-multiline`](docs/rules/arch/jsx-attributes-multiline.md) 🔧 | JSX tags with 3+ attributes go one attribute per line. |
+| Family | Covers | Rules |
+| --- | --- | --- |
+| `backend` | Service and RPC structure | [`backend-orpc-output`](docs/rules/backend-orpc-output.md), [`backend-registry`](docs/rules/backend-registry.md), [`backend-service-functions`](docs/rules/backend-service-functions.md), [`backend-sql-like`](docs/rules/backend-sql-like.md) |
+| `boundaries` | Import and runtime boundaries | [`boundaries-deny`](docs/rules/boundaries-deny.md), [`boundaries-imports`](docs/rules/boundaries-imports.md), [`boundaries-next`](docs/rules/boundaries-next.md), [`boundaries-rpc-database`](docs/rules/boundaries-rpc-database.md), [`boundaries-tanstack`](docs/rules/boundaries-tanstack.md), [`boundaries-token-owner`](docs/rules/boundaries-token-owner.md) |
+| `code` | Code shapes to avoid | [`code-constructor`](docs/rules/code-constructor.md), [`code-double-negation`](docs/rules/code-double-negation.md), [`code-literal-in`](docs/rules/code-literal-in.md), [`code-mutable-state`](docs/rules/code-mutable-state.md), [`code-object-params`](docs/rules/code-object-params.md), [`code-paired-call`](docs/rules/code-paired-call.md), [`code-promise-mutation`](docs/rules/code-promise-mutation.md), [`code-switch`](docs/rules/code-switch.md), [`code-trivial-functions`](docs/rules/code-trivial-functions.md) |
+| `comments` | Comments and directives | [`comments-code`](docs/rules/comments-code.md) 🔧, [`comments-directives`](docs/rules/comments-directives.md) |
+| `copy` | User-facing text | [`copy-dashes`](docs/rules/copy-dashes.md) |
+| `files` | What a file may contain or export | [`files-components-only`](docs/rules/files-components-only.md), [`files-constants-only`](docs/rules/files-constants-only.md), [`files-domain-constants`](docs/rules/files-domain-constants.md), [`files-exports`](docs/rules/files-exports.md), [`files-externals`](docs/rules/files-externals.md), [`files-factory-keys`](docs/rules/files-factory-keys.md), [`files-helpers`](docs/rules/files-helpers.md), [`files-no-functions`](docs/rules/files-no-functions.md), [`files-restricted`](docs/rules/files-restricted.md), [`files-route`](docs/rules/files-route.md), [`files-types-only`](docs/rules/files-types-only.md) |
+| `layout` | Layout a formatter leaves alone | [`layout-call-arguments`](docs/rules/layout-call-arguments.md) 🔧, [`layout-call-array`](docs/rules/layout-call-array.md) 🔧, [`layout-chain`](docs/rules/layout-chain.md) 🔧, [`layout-jsx-attributes`](docs/rules/layout-jsx-attributes.md) 🔧, [`layout-key-value`](docs/rules/layout-key-value.md) 🔧, [`layout-object`](docs/rules/layout-object.md) 🔧, [`layout-padding`](docs/rules/layout-padding.md) 🔧, [`layout-ternary`](docs/rules/layout-ternary.md) 🔧 |
+| `naming` | File, folder and export names | [`naming-declarations`](docs/rules/naming-declarations.md), [`naming-exports`](docs/rules/naming-exports.md), [`naming-file`](docs/rules/naming-file.md), [`naming-folder`](docs/rules/naming-folder.md), [`naming-types`](docs/rules/naming-types.md) |
+| `react` | Components, effects, class names | [`react-dynamic-classes`](docs/rules/react-dynamic-classes.md), [`react-empty-effect`](docs/rules/react-empty-effect.md), [`react-memo`](docs/rules/react-memo.md), [`react-props`](docs/rules/react-props.md) |
+| `schemas` | Schema placement | [`schemas-inline`](docs/rules/schemas-inline.md), [`schemas-local`](docs/rules/schemas-local.md), [`schemas-rederive`](docs/rules/schemas-rederive.md), [`schemas-single-use`](docs/rules/schemas-single-use.md) |
+| `tests` | Test structure | [`tests-assertions`](docs/rules/tests-assertions.md), [`tests-concurrent-db`](docs/rules/tests-concurrent-db.md), [`tests-modifiers`](docs/rules/tests-modifiers.md), [`tests-titles`](docs/rules/tests-titles.md) |
+| `types` | Type placement and shape | [`types-declarations`](docs/rules/types-declarations.md), [`types-imported-alias`](docs/rules/types-imported-alias.md), [`types-inline`](docs/rules/types-inline.md), [`types-local-alias`](docs/rules/types-local-alias.md), [`types-namespace-import`](docs/rules/types-namespace-import.md), [`types-service`](docs/rules/types-service.md), [`types-unknown`](docs/rules/types-unknown.md) |
+<!-- generated:end -->
+
+Also bundled: [Dillon Mulroy's anti-slop rules](docs/vendor.md) as `oxlint-plugin-arch/dillon-anti-slop`.
 
 > [!WARNING]
-
-### `modules/*`
-
-Rules the preset uses to keep its policies from overwriting each other. You can also register them on their own.
-
-| Rule | What it enforces |
-| --- | --- |
-| [`backend-switch`](docs/rules/modules/backend-switch.md) | Do not use `switch` in backend application code. Use ts-pattern instead. |
-| [`concurrent-db`](docs/rules/modules/concurrent-db.md) | Concurrent tests must not destructure a `db` fixture. Use an isolated database fixture instead. |
-| [`domain-constants`](docs/rules/modules/domain-constants.md) | Move module data to a domain `.constants.ts` file. Do not keep SCREAMING_SNAKE constants (or configured data) in the service file. |
-| [`double-negation`](docs/rules/modules/double-negation.md) | Do not coerce with `!!`. Use `Boolean(value)` or an explicit comparison. |
-| [`dynamic-classes`](docs/rules/modules/dynamic-classes.md) | Write complete `className` strings. Do not build them with template expressions or `+`. |
-| [`empty-effect`](docs/rules/modules/empty-effect.md) | Remove `useEffect` / `useLayoutEffect` callbacks whose body is empty. |
-| [`import-boundaries`](docs/rules/modules/import-boundaries.md) | Reject imports that cross configured application boundaries, including type-only imports. |
-| [`local-type-alias`](docs/rules/modules/local-type-alias.md) | Do not declare type aliases in component and hook files. Use an interface named for the owner, or move derived aliases to domain types. |
-| [`memoization`](docs/rules/modules/memoization.md) | Do not import or call React `memo`, `useMemo` or `useCallback`. Use the React Compiler. Unrelated `cache.memo` calls are left alone. |
-| [`next-runtime`](docs/rules/modules/next-runtime.md) | Check Next.js runtime ownership from file names and directives. `.server` / `.rsc` and `'use server'` modules stay off the browser. `.client` and `'use client'` modules stay off server-only APIs. Shared modules use neither. |
-| [`no-unknown`](docs/rules/modules/no-unknown.md) | Do not write the `unknown` type. Use an owned domain type. |
-| [`pascal-interface`](docs/rules/modules/pascal-interface.md) | Interface names must be PascalCase. |
-| [`reasoned-directives`](docs/rules/modules/reasoned-directives.md) | Lint disables must name specific rules and explain why after `--`. |
-| [`rpc-database`](docs/rules/modules/rpc-database.md) | RPC handlers must not call the database. Delegate that work to services. |
-| [`service-functions`](docs/rules/modules/service-functions.md) | Keep backend operations strict. Frontend modules may expose several operations, with helpers nested inside them. |
-| [`service-types`](docs/rules/modules/service-types.md) | Only the matching factory-derived `Service` alias may stay in a service file. Types such as `ChatDeps` belong in domain types. |
-| [`shape-suffix`](docs/rules/modules/shape-suffix.md) | Do not name a declaration with a `Shape` suffix. Name it for its domain role. |
-| [`tanstack-runtime`](docs/rules/modules/tanstack-runtime.md) | Check direct runtime dependencies and imported TanStack execution boundaries. Compilation still owns graph isolation. |
-| [`test-assertions`](docs/rules/modules/test-assertions.md) | Every test case must contain a recognized assertion, and `expect` calls must sit inside a test or assertion helper. |
-| [`test-modifiers`](docs/rules/modules/test-modifiers.md) | Reject focused, skipped and placeholder tests, including renamed imports such as `check.only`. |
-
-### `dillon-anti-slop/*`
-
-15 vendored [anti-slop](https://github.com/dmmulroy/anti-slop) rules by Dillon Mulroy. [List](docs/rules/dillon-anti-slop.md). Rules with local options have their own page:
-
-| Rule | What it enforces |
-| --- | --- |
-| [`no-module-mocking`](docs/rules/dillon-anti-slop/no-module-mocking.md) | No `vi.mock` or `jest.mock`. Options also ban stubs such as `vi.spyOn`. |
-
-## ⚡ Benchmarks
-
-Wall time for a full `oxlint` run over three real TypeScript monorepos, best of 5, including process startup.
-
-| Project | Files | Lines | Plugin loaded, no rules | [Monorepo example](examples/monorepo.oxlint.config.ts) | All 42 rules on every file |
-| --- | ---: | ---: | ---: | ---: | ---: |
-| Small | 246 | 14.5k | 0.09s | **0.20s** | 0.23s |
-| Medium | 792 | 100.5k | 0.10s | **0.49s** | 0.69s |
-| Large | 1,880 | 190k | 0.10s | **0.72s** | 1.08s |
+> Upgrading from 0.11 or earlier: the preset API, rule IDs and entry points changed. See the [changelog](CHANGELOG.md).
 
 ## 📄 License
 
-MIT
+MIT. The `dillon-anti-slop` rules are by [Dillon Mulroy](https://github.com/dmmulroy/anti-slop), MIT, vendored with [attribution](src/vendor/dillon-anti-slop/UPSTREAM.md).