oxlint-plugin-arch 0.6.3 → 0.8.0

package/dist/presets/tanstack-start-react-modules-preset.d.ts

@@ -1,3 +1,4 @@
 import type { OxlintConfig } from 'oxlint';
 import type { PresetOptions } from '../types/preset.types.ts';
+/** The React modules preset with TanStack Start as the default web framework. */
 export default function tanstackStartReactModulesPreset(options?: PresetOptions): OxlintConfig;

package/dist/presets/tanstack-start-react-modules-preset.js

@@ -418,6 +418,34 @@ var presetTestRules = {
   "vitest/no-conditional-expect": "error",
   "vitest/require-mock-type-parameters": "error"
 };
+var presetModuleMockingApis = ["*.mock", "*.doMock", "*.unstable_mockModule"];
+var presetTestMockingApis = {
+  modules: presetModuleMockingApis,
+  strict: [...presetModuleMockingApis, "*.spyOn", "*.stubGlobal", "*.stubEnv"]
+};
+var presetTestMockingAllow = {
+  modules: [],
+  strict: [{ files: ["**/*.driver.test.ts"], apis: ["*"] }]
+};
+var presetStrictMockingMessage = "Inject a fake driver through the dependencies of the code under test instead of mocking or stubbing.";
+var presetNextHandlerMethods = ["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS"];
+var presetNextSegmentConfig = [
+  "generateStaticParams",
+  "dynamic",
+  "dynamicParams",
+  "revalidate",
+  "fetchCache",
+  "runtime",
+  "preferredRegion",
+  "maxDuration"
+];
+var presetNextSegmentExports = [
+  "generateMetadata",
+  "metadata",
+  "generateViewport",
+  "viewport",
+  ...presetNextSegmentConfig
+];
 var presetExportPrefix = {
   stem: "before-first-dot",
   trailingRoles: ["constants", "utils", "handler", "service", "types"],
@@ -436,7 +464,7 @@ var presetGeneratedFiles = [
 
 // src/utils/helpers/preset.ts
 function presetScopes(roots, suffix = `**/${presetExtensions}`) {
-  return roots.map((root) => `${root}/${suffix}`);
+  return roots.map((root) => root === "." ? suffix : `${root}/${suffix}`);
 }
 function presetOverride(files, rules, excludeFiles = []) {
   return {
@@ -445,6 +473,18 @@ function presetOverride(files, rules, excludeFiles = []) {
     rules
   };
 }
+function presetRuleSeverities(rules, severities) {
+  const result = structuredClone(rules);
+  for (const [name, level] of Object.entries(severities)) {
+    const value = result[name];
+    const current = Array.isArray(value) ? value[0] : value;
+    if (value === undefined || current === "off" || current === "allow" || current === 0) {
+      continue;
+    }
+    result[name] = Array.isArray(value) && level !== "off" ? [level, ...value.slice(1)] : level;
+  }
+  return result;
+}
 function presetPackageName(root, directory) {
   try {
     const manifest = JSON.parse(readFileSync(resolve(root, directory, "package.json"), "utf8"));
@@ -469,7 +509,14 @@ function presetSeverity(rules, level) {
 function presetSourceConfig(context) {
   const { options, web, scripts, app, appFiles, backendFiles, ui, safetyFiles, publicEntrypoints, baseImports } = context;
   const policies = {};
-  policies.formatting = [presetOverride([`**/${presetExtensions}`], presetFormattingRules)];
+  const { semi = "always", quotes = "single" } = options.formatting ?? {};
+  policies.formatting = [
+    presetOverride([`**/${presetExtensions}`], {
+      ...presetFormattingRules,
+      "eslint-js/semi": ["error", semi],
+      "eslint-js/quotes": ["error", quotes, { avoidEscape: true }]
+    })
+  ];
   policies.statementLayout = [
     presetOverride([`**/${presetExtensions}`], {
       "arch/padding-between-statements": ["error", { multilineVariables: true }],
@@ -555,12 +602,18 @@ function presetTypesConfig(context) {
     safetyFiles,
     components,
     hooks,
-    publicEntrypoints
+    publicEntrypoints,
+    tanstackWeb,
+    nextWeb
   } = context;
+  const schemaOwners = backend.length ? backend : nextWeb;
+  const runtimeFreeTypes = backend.length ? web : tanstackWeb;
+  const colocatedTypes = options.modules?.colocatedTypeFiles ?? [];
   const policies = {};
   policies.typePlacement = [
     presetOverride(appFiles, { "arch/no-type-declarations": "error" }, [
       ...types,
+      ...colocatedTypes,
       ...components,
       ...hooks,
       ...services,
@@ -583,16 +636,18 @@ function presetTypesConfig(context) {
     ...options.react?.componentProps === false ? [] : [presetOverride(components, { "arch/component-props": ["error", { filePrefix: true }] }, [...ui, ...testFiles])],
     presetOverride(presetScopes(app, "**/*.types.ts"), {
       "arch/no-restricted-files": ["error", { message: "Domain types belong in src/types." }]
-    }, [...types, ...ui]),
+    }, [...types, ...colocatedTypes, ...ui]),
     presetOverride(presetScopes(app, "**/*.{utils,constants}.ts"), {
       "arch/no-type-declarations": "error"
     }, [...ui, ...testFiles]),
-    presetOverride([...presetScopes(backend, "types/**/*.types.ts"), ...presetScopes(app, "**/*.constants.ts")], {
+    presetOverride([...presetScopes(schemaOwners, "types/**/*.types.ts"), ...colocatedTypes, ...presetScopes(app, "**/*.constants.ts")], {
       "arch/no-top-level-functions": ["error", { banReExports: false }]
     }),
-    presetOverride(presetScopes(web, "types/**/*.types.ts"), {
-      "arch/no-runtime-in-types": ["error", { runtimeImports: "ban", allowImportSources: [], banReExports: true }]
-    })
+    ...runtimeFreeTypes.length ? [
+      presetOverride(presetScopes(runtimeFreeTypes, "types/**/*.types.ts"), {
+        "arch/no-runtime-in-types": ["error", { runtimeImports: "ban", allowImportSources: [], banReExports: true }]
+      })
+    ] : []
   ];
   policies.typeSafety = [
     presetOverride(safetyFiles, {
@@ -629,7 +684,7 @@ function presetTypesConfig(context) {
   policies.schemas = [
     presetOverride(appFiles, {
       "arch/no-local-schema-construction": ["error", { packages: ["zod"], namespaces: ["z"] }]
-    }, [...presetScopes(backend, "types/**"), ...ui]),
+    }, [...presetScopes(schemaOwners, "types/**"), ...colocatedTypes, ...ui]),
     presetOverride(webFiles, {
       "arch/no-rederive-schema": [
         "error",
@@ -668,8 +723,9 @@ function presetTypesConfig(context) {
 }
 
 // src/configs/modules.ts
+import { posix } from "node:path";
 function presetModulesConfig(context) {
-  const { web, backend, app, services, utilities, ui, testFiles, components, hooks, options } = context;
+  const { web, nextWeb, backend, app, services, utilities, ui, testFiles, components, hooks, options } = context;
   const conceptFiles = (options.modules?.customFileRoles ?? []).map((role) => `**/*.${role}.ts`);
   const migrations = options.modules?.migrationFiles ?? [];
   const frontendEntries = [
@@ -703,7 +759,7 @@ function presetModulesConfig(context) {
         })
       ] : []
     ]),
-    presetOverride(presetScopes(web.filter((path) => !context.folders.some((scope) => scope.path === path + "/components")), `components/*/*/**/${presetExtensions}`), {
+    presetOverride(presetScopes(web.filter((path) => !context.folders.some((scope) => scope.path === posix.join(path, "components"))), `components/*/*/**/${presetExtensions}`), {
       "arch/no-restricted-files": ["error", { message: "Components allow one group folder." }]
     }, ui),
     presetOverride([...presetScopes(web, "components/**/*.ts"), ...presetScopes(web, "hooks/**/*.tsx")], {
@@ -719,7 +775,13 @@ function presetModulesConfig(context) {
           message: "Frontend services use .client.ts, .server.ts or .rsc.{ts,tsx}; shared domain helpers use .utils.ts and values use .constants.ts."
         }
       ]
-    }, ["**/*.{client,server,rsc,utils,constants}.ts", "**/*.rsc.tsx", ...conceptFiles])
+    }, [
+      "**/*.{client,server,rsc,utils,constants}.ts",
+      "**/*.rsc.tsx",
+      ...presetScopes(nextWeb, "services/**/*.action.ts"),
+      ...conceptFiles,
+      ...options.modules?.colocatedTypeFiles ?? []
+    ])
   ];
   policies.serviceStructure = [
     presetOverride(services, {
@@ -837,9 +899,9 @@ function presetModulesConfig(context) {
       "arch/export-name-pattern": ["error", { pattern: "^use[A-Z]", ignoreTypeExports: true }]
     }),
     presetOverride(components, {
-      "arch/only-export-components": ["error", { matchFileName: true, allowTypeExports: true }]
+      "arch/only-export-components": ["error", { matchFileName: true, allowTypeExports: true, trailingRoles: ["illustration"] }]
     }, [...ui, ...testFiles]),
-    presetOverride(presetScopes(web.filter((path) => !context.folders.some((scope) => scope.path === path + "/components")), "components/**/*.tsx"), {
+    presetOverride(presetScopes(web.filter((path) => !context.folders.some((scope) => scope.path === posix.join(path, "components"))), "components/**/*.tsx"), {
       "arch/folder-prefix": ["error", { singularize: "trailing-s", separators: ["-"] }]
     }, [...ui, ...testFiles]),
     ...["action", "query"].map((role) => presetOverride([
@@ -897,9 +959,15 @@ function presetModulesConfig(context) {
   return policies;
 }
 
+// src/utils/helpers/mocking.ts
+function mockingApiPatternsAssert(patterns) {
+  if (patterns.some((pattern) => !/^(?:\*|(?:vi|jest|\*)\.(?:[A-Za-z_$][\w$]*|\*))$/.test(pattern)))
+    throw new Error("Test mocking APIs must be `*` or `<vi|jest|*>.<method|*>`.");
+}
+
 // src/configs/tests.ts
 function presetTestsConfig(context) {
-  const { backend, testFiles, baseImports, options } = context;
+  const { backendRoots, testFiles, baseImports, options } = context;
   const profile = options.tests?.profile ?? "fixtures";
   if (profile !== "standard" && profile !== "fixtures")
     throw new Error("Unknown test profile.");
@@ -909,11 +977,30 @@ function presetTestsConfig(context) {
     throw new Error("Additional test functions must be literal identifiers or dotted names.");
   if (assertionFunctions.some((name) => !/^[A-Za-z_$][\w$]*(?:\.[\w$*]+)*$/.test(name)))
     throw new Error("Assertion functions must be rooted dotted names or patterns.");
+  const mocking = typeof options.tests?.mocking === "string" ? { preset: options.tests.mocking } : options.tests?.mocking ?? {};
+  const mockingPreset = mocking.preset ?? "modules";
+  if (mockingPreset !== "modules" && mockingPreset !== "strict")
+    throw new Error("Unknown test mocking preset.");
+  const mockingDeny = [...mocking.deny ?? [], ...presetTestMockingApis[mockingPreset]].map((entry) => {
+    if (typeof entry !== "string")
+      return entry;
+    return mockingPreset === "strict" ? { api: entry, message: presetStrictMockingMessage } : entry;
+  });
+  const mockingAllow = [...presetTestMockingAllow[mockingPreset], ...mocking.allow ?? []].sort((left, right) => Number(left.apis.includes("*")) - Number(right.apis.includes("*")));
+  mockingApiPatternsAssert([
+    ...mockingDeny.map((entry) => typeof entry === "string" ? entry : entry.api),
+    ...mockingAllow.flatMap((entry) => entry.apis)
+  ]);
+  const mockingCustomized = mockingPreset !== "modules" || (mocking.deny ?? []).length > 0;
+  const mockingRule = (allow) => [
+    "error",
+    { deny: mockingDeny, allow: ["*.fn", ...allow], checkDestructured: mockingCustomized }
+  ];
   const policies = {};
   policies.tests = [
     presetOverride(testFiles, {
       ...presetTestRules,
-      "dillon-anti-slop/no-module-mocking": "error",
+      "dillon-anti-slop/no-module-mocking": mockingCustomized ? mockingRule([]) : "error",
       "modules/test-modifiers": [
         "error",
         { additionalTestFunctions: options.tests?.additionalTestFunctions ?? [] }
@@ -930,7 +1017,7 @@ function presetTestsConfig(context) {
         { callees: ["describe", ...testFunctions], forbid: "^should\\b", flags: "i" }
       ]
     }),
-    presetOverride(presetScopes(backend.map((path) => path.replace(/\/src$/, "")), "tests/**/*.ts"), {
+    presetOverride(presetScopes(backendRoots, "tests/**/*.ts"), {
       "modules/concurrent-db": "error",
       ...profile === "fixtures" ? {
         "no-restricted-imports": [
@@ -946,14 +1033,17 @@ function presetTestsConfig(context) {
           }
         ]
       } : {}
-    })
+    }),
+    ...mockingAllow.map((entry) => presetOverride(entry.files, {
+      "dillon-anti-slop/no-module-mocking": entry.apis.includes("*") ? "off" : mockingRule(entry.apis)
+    }))
   ];
   return policies;
 }
 
 // src/configs/react.ts
 function presetReactConfig(context) {
-  const { options, web, webFiles, ui, testFiles, components, css } = context;
+  const { options, web, tanstackWeb, nextWeb, webFiles, ui, testFiles, components, css } = context;
   const policies = {};
   if (web.length) {
     policies.react = [
@@ -975,9 +1065,10 @@ function presetReactConfig(context) {
   if (web.length) {
     policies.effects = [presetOverride(webFiles, { ...presetEffectsRules, "modules/empty-effect": "error" }, ui)];
   }
-  if (web.length) {
-    policies.routes = [
-      presetOverride(presetScopes(web, "routes/**/*.{ts,tsx}"), {
+  const nextPage = { bannedHooks: ["useState", "useEffect", "useMutation"], inspectExports: true };
+  const routes = [
+    ...tanstackWeb.length ? [
+      presetOverride(presetScopes(tanstackWeb, "routes/**/*.{ts,tsx}"), {
         "arch/route-surface": [
           "error",
           {
@@ -987,7 +1078,7 @@ function presetReactConfig(context) {
           }
         ]
       }, testFiles),
-      presetOverride(presetScopes(web, "routes/handlers/**/*.ts"), {
+      presetOverride(presetScopes(tanstackWeb, "routes/handlers/**/*.ts"), {
         "arch/no-file-level-helpers": [
           "error",
           {
@@ -996,7 +1087,43 @@ function presetReactConfig(context) {
           }
         ]
       })
-    ];
+    ] : [],
+    ...nextWeb.length ? [
+      presetOverride(presetScopes(nextWeb, "app/**/{page,template,default,not-found,forbidden,unauthorized,loading}.tsx"), {
+        "arch/route-surface": [
+          "error",
+          { exportName: "default", allowedExports: presetNextSegmentExports, banIntrinsicJsx: true, ...nextPage }
+        ]
+      }, [...testFiles, ...presetScopes(nextWeb, "app/not-found.tsx")]),
+      presetOverride([...presetScopes(nextWeb, "app/**/{layout,global-not-found}.tsx"), ...presetScopes(nextWeb, "app/not-found.tsx")], {
+        "arch/route-surface": [
+          "error",
+          { exportName: "default", allowedExports: presetNextSegmentExports, banIntrinsicJsx: false, ...nextPage }
+        ]
+      }, testFiles),
+      presetOverride(presetScopes(nextWeb, "app/**/route.ts"), {
+        "arch/route-surface": [
+          "error",
+          {
+            exportName: "GET",
+            allowedExports: [...presetNextHandlerMethods.slice(1), ...presetNextSegmentConfig],
+            bannedHooks: [],
+            banIntrinsicJsx: false
+          }
+        ],
+        "arch/no-file-level-helpers": [
+          "error",
+          {
+            detectComponents: false,
+            allowPattern: `^(${[...presetNextHandlerMethods, ...presetNextSegmentConfig].join("|")})$`,
+            message: "Nest this helper in its owning route handler, or move genuine domain logic to a service. Do not create a component, hook or public helper to bypass this rule."
+          }
+        ]
+      })
+    ] : []
+  ];
+  if (routes.length) {
+    policies.routes = routes;
   }
   if (web.length) {
     policies.forms = [
@@ -1049,23 +1176,51 @@ function presetReactConfig(context) {
       `${group}-[env(safe-area-inset-${side})]`,
       ...group === "p" ? [] : [`${group}-[max(--spacing(*),env(safe-area-inset-${side}))]`]
     ]));
+    const illustrationPalette = [
+      "text-color",
+      "bg-color",
+      "gradient-from",
+      "gradient-via",
+      "gradient-to",
+      "border-color",
+      "divide-color",
+      "outline-color",
+      "ring-color",
+      "ring-offset-color",
+      "shadow",
+      "shadow-color",
+      "inset-shadow",
+      "inset-shadow-color",
+      "drop-shadow",
+      "drop-shadow-color",
+      "fill",
+      "stroke",
+      "bg-image",
+      "bg-size",
+      "bg-position",
+      "mask-image",
+      "blur",
+      "saturate"
+    ];
+    const restyle = (base) => ({
+      allow: base,
+      contracts: [
+        { pattern: "^(CardContent|PopoverContent)$", allow: [...base, ...padding] },
+        { pattern: "^TabsContent$", allow: [...base, ...gap, ...padding] },
+        { pattern: "^(Tabs|HoverCardContent|SidebarHeader|BreadcrumbList)$", allow: [...base, ...gap] }
+      ]
+    });
     policies.shadcn = [
       presetOverride(webFiles, {
-        "shadcn/no-restyle": [
-          "error",
-          {
-            allow,
-            contracts: [
-              { pattern: "^(CardContent|PopoverContent)$", allow: [...allow, ...padding] },
-              { pattern: "^TabsContent$", allow: [...allow, ...gap, ...padding] },
-              { pattern: "^(Tabs|HoverCardContent|SidebarHeader|BreadcrumbList)$", allow: [...allow, ...gap] }
-            ]
-          }
-        ],
+        "shadcn/no-restyle": ["error", restyle(allow)],
         "shadcn/no-arbitrary-values": ["error", { allow: ["layout", ...safeArea] }],
         "shadcn/require-static-classes": "error",
         "modules/dynamic-classes": "error"
       }, ui),
+      presetOverride(presetScopes(web, "components/**/*.illustration.tsx"), {
+        "shadcn/no-restyle": ["error", restyle([...allow, ...illustrationPalette])],
+        "shadcn/no-arbitrary-values": ["error", { allow: ["layout", ...safeArea, ...illustrationPalette] }]
+      }, ui),
       presetOverride(webFiles, {
         "shadcn/no-unknown-classes": ["error", { allow: [] }]
       }),
@@ -1080,7 +1235,16 @@ function presetReactConfig(context) {
 // src/configs/boundaries.ts
 import { resolve as resolve2 } from "node:path";
 function presetBoundariesConfig(context) {
-  const { options, root, architecture, packages, web, backend, appFiles, publicEntrypoints, baseImports } = context;
+  const { options, root, architecture, packages, web, tanstackWeb, nextWeb, backend, appFiles, publicEntrypoints, baseImports } = context;
+  const runtimeBoundary = {
+    web: web.map((path) => resolve2(root, path)),
+    backend: backend.map((path) => resolve2(root, path)),
+    aliases: Object.fromEntries(Object.entries(options.imports?.aliases ?? {}).map(([alias, path]) => [alias.replace(/\/$/, ""), resolve2(root, path)])),
+    backendPackages: Object.entries(architecture).flatMap(([directory, { role }]) => {
+      const name = role === "server" || role === "runner" ? presetPackageName(root, directory) : undefined;
+      return name ? [name] : [];
+    })
+  };
   const policies = {};
   policies.boundaries = [
     presetOverride([...appFiles, ...presetScopes(packages, "**/" + presetExtensions)], {
@@ -1108,20 +1272,11 @@ function presetBoundariesConfig(context) {
         }
       ]
     }),
-    presetOverride([...presetScopes(web, "services/**/*.{ts,tsx}"), ...presetScopes(web, "lib/**/*.{ts,tsx}")], {
+    presetOverride([...presetScopes(tanstackWeb, "services/**/*.{ts,tsx}"), ...presetScopes(tanstackWeb, "lib/**/*.{ts,tsx}")], {
       "modules/tanstack-runtime": [
         "error",
         {
-          web: web.map((path) => resolve2(root, path)),
-          backend: backend.map((path) => resolve2(root, path)),
-          aliases: Object.fromEntries(Object.entries(options.imports?.aliases ?? {}).map(([alias, path]) => [
-            alias.replace(/\/$/, ""),
-            resolve2(root, path)
-          ])),
-          backendPackages: Object.entries(architecture).flatMap(([directory, { role }]) => {
-            const name = role === "server" || role === "runner" ? presetPackageName(root, directory) : undefined;
-            return name ? [name] : [];
-          }),
+          ...runtimeBoundary,
           rpcClients: ((options.orpc?.clientOwnerFile) ? [options.orpc?.clientOwnerFile] : context.rpcClients).map((path) => resolve2(root, path)),
           serverImports: options.tanstackStart?.additionalServerOnlyImports ?? [],
           clientImports: options.tanstackStart?.additionalClientOnlyImports ?? [],
@@ -1129,6 +1284,17 @@ function presetBoundariesConfig(context) {
         }
       ]
     }),
+    presetOverride([...presetScopes(nextWeb, "services/**/*.{ts,tsx}"), ...presetScopes(nextWeb, "lib/**/*.{ts,tsx}")], {
+      "modules/next-runtime": [
+        "error",
+        {
+          ...runtimeBoundary,
+          serverImports: options.next?.additionalServerOnlyImports ?? [],
+          clientImports: options.next?.additionalClientOnlyImports ?? [],
+          allowComputedImportsIn: options.next?.computedImportAllowedFiles?.map((path) => resolve2(root, path)) ?? []
+        }
+      ]
+    }),
     presetOverride(presetScopes(backend, "rpc/**/*.ts"), {
       "modules/rpc-database": "error",
       "no-restricted-imports": ["error", { paths: ["kysely"], patterns: baseImports }]
@@ -1191,7 +1357,7 @@ function presetPluginsConfig(context) {
 }
 
 // src/services/preset-context.ts
-import { resolve as resolve3, posix } from "node:path";
+import { resolve as resolve3, posix as posix2 } from "node:path";
 function presetResolveContext(options) {
   const generated = presetGeneratedFiles;
   const root = resolve3(options.root ?? process.cwd());
@@ -1205,13 +1371,24 @@ function presetResolveContext(options) {
     const entry = typeof configuredRoot === "string" ? { role: configuredRoot } : configuredRoot;
     if (!entry || typeof entry !== "object")
       throw new Error("Architecture entries must be roles or role/layout objects.");
-    if (Object.keys(entry).some((key) => !["role", "layout"].includes(key)))
+    if (Object.keys(entry).some((key) => !["role", "layout", "framework", "sourceDir"].includes(key)))
       throw new Error("Unknown architecture entry option.");
     const role = entry.role;
+    if ("framework" in entry && entry.framework !== undefined && role !== "web")
+      throw new Error("Only web architecture roots accept a framework.");
+    const framework = role === "web" ? entry.framework ?? options.framework ?? "tanstack-start" : undefined;
+    if (framework !== undefined && framework !== "tanstack-start" && framework !== "next")
+      throw new Error(`Unknown framework: ${framework}`);
+    const sourced = role === "web" || role === "server" || role === "runner";
+    if ("sourceDir" in entry && entry.sourceDir !== undefined && !sourced)
+      throw new Error("Only web, server and runner architecture roots accept a sourceDir.");
+    const sourceDir = entry.sourceDir ?? "src";
+    if (typeof sourceDir !== "string" || sourceDir !== "." && sourceDir.split("/").some((segment) => !/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(segment)))
+      throw new Error("Source folders must be `.` or literal root-relative paths without escapes, globs or empty segments.");
     const portable = path.replaceAll("\\", "/");
-    if (!portable.trim() || posix.isAbsolute(portable) || /^[a-z]:/i.test(portable))
+    if (!portable.trim() || posix2.isAbsolute(portable) || /^[a-z]:/i.test(portable))
       throw new Error("Architecture roots must be nonempty project-relative paths.");
-    const normalized = posix.normalize(portable).replace(/\/$/, "");
+    const normalized = posix2.normalize(portable).replace(/\/$/, "");
     if (normalized === ".." || normalized.startsWith("../"))
       throw new Error("Architecture roots must stay inside the project.");
     if (!["web", "server", "runner", "scripts", "packages"].includes(role))
@@ -1239,7 +1416,15 @@ function presetResolveContext(options) {
         throw new Error("Layout folders must not overlap.");
       }
     }
-    return [normalized, { role, layout }];
+    return [
+      normalized,
+      {
+        role,
+        layout,
+        ...framework ? { framework } : {},
+        ...entry.sourceDir === undefined ? {} : { sourceDir }
+      }
+    ];
   });
   for (const [index, [path]] of entries.entries()) {
     const overlaps = entries.slice(0, index).some(([other]) => other === path || other === "." || path === "." || other.startsWith(path + "/") || path.startsWith(other + "/"));
@@ -1265,17 +1450,24 @@ function presetResolveContext(options) {
     "spec"
   ].includes(role)))
     throw new Error("File roles must not replace built-in roles.");
-  const web = entries.filter(([, { role }]) => role === "web").map(([path]) => posix.join(path, "src"));
-  const backendRoots = entries.filter(([, { role }]) => role === "server" || role === "runner").map(([path]) => path);
-  const backend = backendRoots.map((path) => posix.join(path, "src"));
+  if (options.framework !== undefined && options.framework !== "tanstack-start" && options.framework !== "next")
+    throw new Error(`Unknown framework: ${options.framework}`);
+  const source = (path, entry) => posix2.join(path, entry.sourceDir ?? "src");
+  const web = entries.filter(([, { role }]) => role === "web").map(([path, entry]) => source(path, entry));
+  const webFor = (framework) => entries.filter(([, entry]) => entry.framework === framework).map(([path, entry]) => source(path, entry));
+  const tanstackWeb = webFor("tanstack-start");
+  const nextWeb = webFor("next");
+  const backendEntries = entries.filter(([, { role }]) => role === "server" || role === "runner");
+  const backendRoots = backendEntries.map(([path]) => path);
+  const backend = backendEntries.map(([path, entry]) => source(path, entry));
   const packages = entries.filter(([, { role }]) => role === "packages").map(([path]) => path);
   const scripts = entries.filter(([, { role }]) => role === "scripts").map(([path]) => path);
   const folders = entries.flatMap(([path, entry]) => Object.entries(entry.layout).map(([folder, mode]) => ({
-    path: posix.join(path, ["web", "server", "runner"].includes(entry.role) ? "src" : "", folder),
+    path: posix2.join(["web", "server", "runner"].includes(entry.role) ? source(path, entry) : path, folder),
     folder,
     mode
   })));
-  const rpcClients = entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => posix.join(path, "src/services", entry.layout.services === "domain" ? "rpc/rpc.client.ts" : "rpc.client.ts"));
+  const rpcClients = entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => posix2.join(source(path, entry), "services", entry.layout.services === "domain" ? "rpc/rpc.client.ts" : "rpc.client.ts"));
   const app = [...web, ...backend];
   const appFiles = presetScopes(app);
   const webFiles = presetScopes(web);
@@ -1301,13 +1493,17 @@ function presetResolveContext(options) {
   ];
   const tailwind = options.tailwind;
   const entryPoints = Object.fromEntries(Object.entries(tailwind === false ? {} : tailwind?.cssEntryPointsByRoot ?? {}).map(([path, entry]) => [
-    posix.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
+    posix2.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
     entry
   ]));
-  const css = tailwind === false ? {} : Object.fromEntries(web.map((path) => [
-    path,
-    resolve3(root, entryPoints[posix.dirname(path)] ?? tailwind?.cssEntryPoint ?? `${path}/application/styles.css`)
-  ]));
+  const css = tailwind === false ? {} : Object.fromEntries(entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => {
+    const sourcePath = source(path, entry);
+    const fallback = entry.framework === "next" ? "app/globals.css" : "application/styles.css";
+    return [
+      sourcePath,
+      resolve3(root, entryPoints[path] ?? tailwind?.cssEntryPoint ?? posix2.join(sourcePath, fallback))
+    ];
+  }));
   return {
     options,
     root,
@@ -1317,7 +1513,10 @@ function presetResolveContext(options) {
     packages,
     scripts,
     web,
+    tanstackWeb,
+    nextWeb,
     backend,
+    backendRoots,
     app,
     appFiles,
     webFiles,
@@ -1341,6 +1540,8 @@ function presetResolveContext(options) {
 // src/services/preset-compose.ts
 function presetCompose(context, policies, plugins) {
   const { options, level, safetyFiles, ui, generated } = context;
+  const severities = options.ruleSeverities ?? {};
+  const levels = (rules) => presetRuleSeverities(presetSeverity(rules, level), severities);
   const overrideList = [];
   for (const name of presetPolicyOrder) {
     const setting = options.policies?.[name];
@@ -1352,14 +1553,16 @@ function presetCompose(context, policies, plugins) {
     for (const entry of entries) {
       overrideList.push({
         ...entry,
-        rules: entry.rules ? presetSeverity(entry.rules, level) : undefined
+        rules: entry.rules ? levels(entry.rules) : undefined
       });
     }
   }
-  overrideList.push(presetOverride(safetyFiles, {
-    "max-lines": [level, { max: options.limits?.maxFileLines ?? 400, skipBlankLines: true, skipComments: true }],
-    complexity: [level, { max: options.limits?.maxFunctionComplexity ?? 32 }]
-  }, ui));
+  overrideList.push(presetOverride(safetyFiles, levels({
+    "max-lines": ["error", { max: options.limits?.maxFileLines ?? 400, skipBlankLines: true, skipComments: true }],
+    complexity: ["error", { max: options.limits?.maxFunctionComplexity ?? 32 }]
+  }), ui));
+  const named = new Set([...Object.keys(presetCommonRules), ...overrideList.flatMap((entry) => Object.keys(entry.rules ?? {}))]);
+  const unnamedLevels = Object.fromEntries(Object.entries(severities).filter(([rule]) => !named.has(rule)));
   for (const [rule, files] of Object.entries(options.ruleExclusions ?? {})) {
     overrideList.push({ files, rules: { [rule]: "off" } });
   }
@@ -1373,17 +1576,18 @@ function presetCompose(context, policies, plugins) {
       "**/build/**",
       "**/coverage/**",
       "**/.output/**",
+      ...context.nextWeb.length ? ["**/.next/**", "**/next-env.d.ts"] : [],
       ...generated,
       ...options.ignorePatterns ?? []
     ],
     ...plugins,
-    rules: presetSeverity(presetCommonRules, level),
+    rules: { ...levels(presetCommonRules), ...unnamedLevels },
     overrides: overrideList.filter((entry) => entry.files.length > 0)
   };
 }
 
-// src/presets/tanstack-start-react-modules-preset.ts
-function tanstackStartReactModulesPreset(options = {}) {
+// src/presets/react-modules-preset.ts
+function reactModulesPreset(options = {}) {
   const context = presetResolveContext(options);
   return presetCompose(context, {
     ...presetSourceConfig(context),
@@ -1394,6 +1598,11 @@ function tanstackStartReactModulesPreset(options = {}) {
     ...presetBoundariesConfig(context)
   }, presetPluginsConfig(context));
 }
+
+// src/presets/tanstack-start-react-modules-preset.ts
+function tanstackStartReactModulesPreset(options = {}) {
+  return reactModulesPreset({ ...options, framework: options.framework ?? "tanstack-start" });
+}
 export {
   tanstackStartReactModulesPreset as default
 };