oxlint-plugin-arch 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 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.
+- `arch/no-trivial-functions` no longer reports type guards with a predicate return type as pass-through wrappers. Banned names and structurally generic guards are still reported.
+- Package schemas: construction is allowed only in `types/**`. Package `*.types.ts` files outside `types/` are reported again (fix: move them to `src/types/`), matching `arch/no-restricted-files`.
+- Hook filenames accept a React Native platform suffix: `use-chat-draft.web.ts`, `.native.ts`, `.ios.ts` and `.android.ts`. This applies to web roots and packages.
+- A UI kit outside every web root, resolved from `shadcn.ui`, gets the Tailwind checks. Its stylesheet is `tailwind.cssEntryPointsByRoot` for the kit's package folder or architecture root, otherwise the one stylesheet the web roots share. With several web stylesheets and no entry, the preset throws and names `cssEntryPointsByRoot`.
+
+| Fix | Rules |
+| --- | --- |
+| Auto-fix (`--fix`) | `tailwindcss/*` sort, canonical, shorthand and whitespace rules on a kit package |
+| Move | `arch/no-local-schema-construction` in package `*.types.ts` outside `types/` (to `src/types/`) |
+| Reshape | `tailwindcss/no-conflicting-classes`, `tailwindcss/no-deprecated-classes` on a kit package |
+
 ## 0.10.0
 
 **Breaking:** `packages` roots now get the app rules. Until now they only got the shared baseline (formatting, imports, stock TypeScript/JavaScript rules and `modules/import-boundaries`), so expect new errors in package `src` folders.

package/dist/index.js

@@ -4089,7 +4089,7 @@ var noTrivialFunctions = defineRule32({
           }
           seen.add(key);
           checkHelper(item.node);
-          if (reported.has(item.node.start))
+          if (reported.has(item.node.start) || item.node.returnType?.typeAnnotation.type === "TSTypePredicate")
             continue;
           const expression = trivialExpression(item.node);
           const trivial2 = mode === "legacy" ? declarationsIsTrivialFunction(item.node) : expression ? trivialIsForwarder(item.node, expression) : declarationsIsTrivialFunction(item.node);

package/dist/presets/index.js

@@ -747,7 +747,6 @@ function presetTypesConfig(context) {
       "arch/no-local-schema-construction": ["error", { packages: ["zod"], namespaces: ["z"] }]
     }, [
       ...presetScopes([...schemaOwners, ...packageSources], "types/**"),
-      ...presetScopes(packageSources, "**/*.types.ts"),
       ...colocatedTypes,
       ...ui
     ]),
@@ -957,8 +956,8 @@ function presetModulesConfig(context) {
       "arch/filename-match": [
         "error",
         {
-          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*[.]ts$",
-          message: "Hooks use use-domain.ts filenames."
+          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*(?:[.](?:web|native|ios|android))?[.]ts$",
+          message: "Hooks use use-domain.ts filenames, with an optional .web, .native, .ios or .android platform suffix."
         }
       ],
       "arch/export-file-prefix": "error",
@@ -1109,9 +1108,8 @@ function presetTestsConfig(context) {
 
 // src/configs/react.ts
 function presetReactConfig(context) {
-  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, uiRoots, ui, testFiles, components, css } = context;
+  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, webUiRoots, ui, testFiles, components, css } = context;
   const policies = {};
-  const webUi = uiRoots.filter((path) => web.some((root) => root === "." || path === root || path.startsWith(root + "/")));
   if (reactFiles.length) {
     policies.react = [
       presetOverride(reactFiles, {
@@ -1221,7 +1219,7 @@ function presetReactConfig(context) {
               },
               {
                 token: "createContext",
-                allowPathPatterns: [...presetScopes(web, "context/"), ...webUi.map((path) => `${path}/`)]
+                allowPathPatterns: [...presetScopes(web, "context/"), ...webUiRoots.map((path) => `${path}/`)]
               }
             ]
           }
@@ -1291,7 +1289,7 @@ function presetReactConfig(context) {
       presetOverride(webFiles, {
         "shadcn/no-unknown-classes": ["error", { allow: [] }]
       }),
-      presetOverride(presetScopes(webUi, "sonner.tsx"), {
+      presetOverride(presetScopes(webUiRoots, "sonner.tsx"), {
         "shadcn/no-unknown-classes": ["error", { allow: ["toaster", "toast"] }]
       })
     ];
@@ -1576,6 +1574,7 @@ function presetResolveContext(options) {
     throw new Error("shadcn.componentImportSources was renamed to shadcn.components.");
   const uiRoots = shadcn.ui === undefined ? web.map((path) => posix2.join(path, "components/ui")) : resolveUi(shadcn.ui);
   const ui = presetScopes(uiRoots, "**");
+  const webUiRoots = uiRoots.filter((path) => web.some((webRoot) => webRoot === "." || path === webRoot || path.startsWith(webRoot + "/")));
   const testFiles = ["**/{test,tests,e2e}/**/*.{ts,tsx,mts,cts}", "**/*.{test,spec}.{ts,tsx,mts,cts}"];
   const safetyFiles = [...appFiles, ...testFiles];
   const components = presetScopes([...web, ...packageSources], "components/**/*.tsx");
@@ -1596,7 +1595,7 @@ function presetResolveContext(options) {
     posix2.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
     entry
   ]));
-  const css = tailwind === false ? {} : Object.fromEntries(entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => {
+  const webCss = 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 [
@@ -1604,6 +1603,22 @@ function presetResolveContext(options) {
       resolve3(root, entryPoints[path] ?? tailwind?.cssEntryPoint ?? posix2.join(sourcePath, fallback))
     ];
   }));
+  const webStylesheets = [...new Set(Object.values(webCss))];
+  const kitCss = Object.fromEntries((tailwind === false ? [] : uiRoots.filter((path) => !webUiRoots.includes(path))).map((path) => {
+    const owners = packages.flatMap((packageRoot) => {
+      if (path !== packageRoot && !path.startsWith(packageRoot + "/"))
+        return [];
+      const child = path.slice(packageRoot.length + 1).split("/")[0];
+      return isPackage(packageRoot) || !child ? [packageRoot] : [posix2.join(packageRoot, child), packageRoot];
+    });
+    const entry = owners.map((owner) => entryPoints[owner]).find(Boolean);
+    if (entry)
+      return [path, resolve3(root, entry)];
+    if (webStylesheets.length === 1)
+      return [path, webStylesheets[0]];
+    throw new Error(`The UI kit ${path} needs a Tailwind stylesheet: set tailwind.cssEntryPointsByRoot for ${owners[0] ?? path}.`);
+  }));
+  const css = { ...webCss, ...kitCss };
   return {
     options,
     root,
@@ -1628,6 +1643,7 @@ function presetResolveContext(options) {
     utilities,
     types,
     uiRoots,
+    webUiRoots,
     ui,
     generated,
     testFiles,

package/dist/presets/next-react-modules-preset.js

@@ -747,7 +747,6 @@ function presetTypesConfig(context) {
       "arch/no-local-schema-construction": ["error", { packages: ["zod"], namespaces: ["z"] }]
     }, [
       ...presetScopes([...schemaOwners, ...packageSources], "types/**"),
-      ...presetScopes(packageSources, "**/*.types.ts"),
       ...colocatedTypes,
       ...ui
     ]),
@@ -957,8 +956,8 @@ function presetModulesConfig(context) {
       "arch/filename-match": [
         "error",
         {
-          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*[.]ts$",
-          message: "Hooks use use-domain.ts filenames."
+          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*(?:[.](?:web|native|ios|android))?[.]ts$",
+          message: "Hooks use use-domain.ts filenames, with an optional .web, .native, .ios or .android platform suffix."
         }
       ],
       "arch/export-file-prefix": "error",
@@ -1109,9 +1108,8 @@ function presetTestsConfig(context) {
 
 // src/configs/react.ts
 function presetReactConfig(context) {
-  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, uiRoots, ui, testFiles, components, css } = context;
+  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, webUiRoots, ui, testFiles, components, css } = context;
   const policies = {};
-  const webUi = uiRoots.filter((path) => web.some((root) => root === "." || path === root || path.startsWith(root + "/")));
   if (reactFiles.length) {
     policies.react = [
       presetOverride(reactFiles, {
@@ -1221,7 +1219,7 @@ function presetReactConfig(context) {
               },
               {
                 token: "createContext",
-                allowPathPatterns: [...presetScopes(web, "context/"), ...webUi.map((path) => `${path}/`)]
+                allowPathPatterns: [...presetScopes(web, "context/"), ...webUiRoots.map((path) => `${path}/`)]
               }
             ]
           }
@@ -1291,7 +1289,7 @@ function presetReactConfig(context) {
       presetOverride(webFiles, {
         "shadcn/no-unknown-classes": ["error", { allow: [] }]
       }),
-      presetOverride(presetScopes(webUi, "sonner.tsx"), {
+      presetOverride(presetScopes(webUiRoots, "sonner.tsx"), {
         "shadcn/no-unknown-classes": ["error", { allow: ["toaster", "toast"] }]
       })
     ];
@@ -1576,6 +1574,7 @@ function presetResolveContext(options) {
     throw new Error("shadcn.componentImportSources was renamed to shadcn.components.");
   const uiRoots = shadcn.ui === undefined ? web.map((path) => posix2.join(path, "components/ui")) : resolveUi(shadcn.ui);
   const ui = presetScopes(uiRoots, "**");
+  const webUiRoots = uiRoots.filter((path) => web.some((webRoot) => webRoot === "." || path === webRoot || path.startsWith(webRoot + "/")));
   const testFiles = ["**/{test,tests,e2e}/**/*.{ts,tsx,mts,cts}", "**/*.{test,spec}.{ts,tsx,mts,cts}"];
   const safetyFiles = [...appFiles, ...testFiles];
   const components = presetScopes([...web, ...packageSources], "components/**/*.tsx");
@@ -1596,7 +1595,7 @@ function presetResolveContext(options) {
     posix2.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
     entry
   ]));
-  const css = tailwind === false ? {} : Object.fromEntries(entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => {
+  const webCss = 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 [
@@ -1604,6 +1603,22 @@ function presetResolveContext(options) {
       resolve3(root, entryPoints[path] ?? tailwind?.cssEntryPoint ?? posix2.join(sourcePath, fallback))
     ];
   }));
+  const webStylesheets = [...new Set(Object.values(webCss))];
+  const kitCss = Object.fromEntries((tailwind === false ? [] : uiRoots.filter((path) => !webUiRoots.includes(path))).map((path) => {
+    const owners = packages.flatMap((packageRoot) => {
+      if (path !== packageRoot && !path.startsWith(packageRoot + "/"))
+        return [];
+      const child = path.slice(packageRoot.length + 1).split("/")[0];
+      return isPackage(packageRoot) || !child ? [packageRoot] : [posix2.join(packageRoot, child), packageRoot];
+    });
+    const entry = owners.map((owner) => entryPoints[owner]).find(Boolean);
+    if (entry)
+      return [path, resolve3(root, entry)];
+    if (webStylesheets.length === 1)
+      return [path, webStylesheets[0]];
+    throw new Error(`The UI kit ${path} needs a Tailwind stylesheet: set tailwind.cssEntryPointsByRoot for ${owners[0] ?? path}.`);
+  }));
+  const css = { ...webCss, ...kitCss };
   return {
     options,
     root,
@@ -1628,6 +1643,7 @@ function presetResolveContext(options) {
     utilities,
     types,
     uiRoots,
+    webUiRoots,
     ui,
     generated,
     testFiles,

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

@@ -747,7 +747,6 @@ function presetTypesConfig(context) {
       "arch/no-local-schema-construction": ["error", { packages: ["zod"], namespaces: ["z"] }]
     }, [
       ...presetScopes([...schemaOwners, ...packageSources], "types/**"),
-      ...presetScopes(packageSources, "**/*.types.ts"),
       ...colocatedTypes,
       ...ui
     ]),
@@ -957,8 +956,8 @@ function presetModulesConfig(context) {
       "arch/filename-match": [
         "error",
         {
-          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*[.]ts$",
-          message: "Hooks use use-domain.ts filenames."
+          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*(?:[.](?:web|native|ios|android))?[.]ts$",
+          message: "Hooks use use-domain.ts filenames, with an optional .web, .native, .ios or .android platform suffix."
         }
       ],
       "arch/export-file-prefix": "error",
@@ -1109,9 +1108,8 @@ function presetTestsConfig(context) {
 
 // src/configs/react.ts
 function presetReactConfig(context) {
-  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, uiRoots, ui, testFiles, components, css } = context;
+  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, webUiRoots, ui, testFiles, components, css } = context;
   const policies = {};
-  const webUi = uiRoots.filter((path) => web.some((root) => root === "." || path === root || path.startsWith(root + "/")));
   if (reactFiles.length) {
     policies.react = [
       presetOverride(reactFiles, {
@@ -1221,7 +1219,7 @@ function presetReactConfig(context) {
               },
               {
                 token: "createContext",
-                allowPathPatterns: [...presetScopes(web, "context/"), ...webUi.map((path) => `${path}/`)]
+                allowPathPatterns: [...presetScopes(web, "context/"), ...webUiRoots.map((path) => `${path}/`)]
               }
             ]
           }
@@ -1291,7 +1289,7 @@ function presetReactConfig(context) {
       presetOverride(webFiles, {
         "shadcn/no-unknown-classes": ["error", { allow: [] }]
       }),
-      presetOverride(presetScopes(webUi, "sonner.tsx"), {
+      presetOverride(presetScopes(webUiRoots, "sonner.tsx"), {
         "shadcn/no-unknown-classes": ["error", { allow: ["toaster", "toast"] }]
       })
     ];
@@ -1576,6 +1574,7 @@ function presetResolveContext(options) {
     throw new Error("shadcn.componentImportSources was renamed to shadcn.components.");
   const uiRoots = shadcn.ui === undefined ? web.map((path) => posix2.join(path, "components/ui")) : resolveUi(shadcn.ui);
   const ui = presetScopes(uiRoots, "**");
+  const webUiRoots = uiRoots.filter((path) => web.some((webRoot) => webRoot === "." || path === webRoot || path.startsWith(webRoot + "/")));
   const testFiles = ["**/{test,tests,e2e}/**/*.{ts,tsx,mts,cts}", "**/*.{test,spec}.{ts,tsx,mts,cts}"];
   const safetyFiles = [...appFiles, ...testFiles];
   const components = presetScopes([...web, ...packageSources], "components/**/*.tsx");
@@ -1596,7 +1595,7 @@ function presetResolveContext(options) {
     posix2.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
     entry
   ]));
-  const css = tailwind === false ? {} : Object.fromEntries(entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => {
+  const webCss = 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 [
@@ -1604,6 +1603,22 @@ function presetResolveContext(options) {
       resolve3(root, entryPoints[path] ?? tailwind?.cssEntryPoint ?? posix2.join(sourcePath, fallback))
     ];
   }));
+  const webStylesheets = [...new Set(Object.values(webCss))];
+  const kitCss = Object.fromEntries((tailwind === false ? [] : uiRoots.filter((path) => !webUiRoots.includes(path))).map((path) => {
+    const owners = packages.flatMap((packageRoot) => {
+      if (path !== packageRoot && !path.startsWith(packageRoot + "/"))
+        return [];
+      const child = path.slice(packageRoot.length + 1).split("/")[0];
+      return isPackage(packageRoot) || !child ? [packageRoot] : [posix2.join(packageRoot, child), packageRoot];
+    });
+    const entry = owners.map((owner) => entryPoints[owner]).find(Boolean);
+    if (entry)
+      return [path, resolve3(root, entry)];
+    if (webStylesheets.length === 1)
+      return [path, webStylesheets[0]];
+    throw new Error(`The UI kit ${path} needs a Tailwind stylesheet: set tailwind.cssEntryPointsByRoot for ${owners[0] ?? path}.`);
+  }));
+  const css = { ...webCss, ...kitCss };
   return {
     options,
     root,
@@ -1628,6 +1643,7 @@ function presetResolveContext(options) {
     utilities,
     types,
     uiRoots,
+    webUiRoots,
     ui,
     generated,
     testFiles,

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

@@ -747,7 +747,6 @@ function presetTypesConfig(context) {
       "arch/no-local-schema-construction": ["error", { packages: ["zod"], namespaces: ["z"] }]
     }, [
       ...presetScopes([...schemaOwners, ...packageSources], "types/**"),
-      ...presetScopes(packageSources, "**/*.types.ts"),
       ...colocatedTypes,
       ...ui
     ]),
@@ -957,8 +956,8 @@ function presetModulesConfig(context) {
       "arch/filename-match": [
         "error",
         {
-          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*[.]ts$",
-          message: "Hooks use use-domain.ts filenames."
+          pattern: "^use-[a-z0-9]+(?:-[a-z0-9]+)*(?:[.](?:web|native|ios|android))?[.]ts$",
+          message: "Hooks use use-domain.ts filenames, with an optional .web, .native, .ios or .android platform suffix."
         }
       ],
       "arch/export-file-prefix": "error",
@@ -1109,9 +1108,8 @@ function presetTestsConfig(context) {
 
 // src/configs/react.ts
 function presetReactConfig(context) {
-  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, uiRoots, ui, testFiles, components, css } = context;
+  const { options, web, tanstackWeb, nextWeb, webFiles, reactFiles, webUiRoots, ui, testFiles, components, css } = context;
   const policies = {};
-  const webUi = uiRoots.filter((path) => web.some((root) => root === "." || path === root || path.startsWith(root + "/")));
   if (reactFiles.length) {
     policies.react = [
       presetOverride(reactFiles, {
@@ -1221,7 +1219,7 @@ function presetReactConfig(context) {
               },
               {
                 token: "createContext",
-                allowPathPatterns: [...presetScopes(web, "context/"), ...webUi.map((path) => `${path}/`)]
+                allowPathPatterns: [...presetScopes(web, "context/"), ...webUiRoots.map((path) => `${path}/`)]
               }
             ]
           }
@@ -1291,7 +1289,7 @@ function presetReactConfig(context) {
       presetOverride(webFiles, {
         "shadcn/no-unknown-classes": ["error", { allow: [] }]
       }),
-      presetOverride(presetScopes(webUi, "sonner.tsx"), {
+      presetOverride(presetScopes(webUiRoots, "sonner.tsx"), {
         "shadcn/no-unknown-classes": ["error", { allow: ["toaster", "toast"] }]
       })
     ];
@@ -1576,6 +1574,7 @@ function presetResolveContext(options) {
     throw new Error("shadcn.componentImportSources was renamed to shadcn.components.");
   const uiRoots = shadcn.ui === undefined ? web.map((path) => posix2.join(path, "components/ui")) : resolveUi(shadcn.ui);
   const ui = presetScopes(uiRoots, "**");
+  const webUiRoots = uiRoots.filter((path) => web.some((webRoot) => webRoot === "." || path === webRoot || path.startsWith(webRoot + "/")));
   const testFiles = ["**/{test,tests,e2e}/**/*.{ts,tsx,mts,cts}", "**/*.{test,spec}.{ts,tsx,mts,cts}"];
   const safetyFiles = [...appFiles, ...testFiles];
   const components = presetScopes([...web, ...packageSources], "components/**/*.tsx");
@@ -1596,7 +1595,7 @@ function presetResolveContext(options) {
     posix2.normalize(path.replaceAll("\\", "/")).replace(/\/$/, ""),
     entry
   ]));
-  const css = tailwind === false ? {} : Object.fromEntries(entries.filter(([, entry]) => entry.role === "web").map(([path, entry]) => {
+  const webCss = 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 [
@@ -1604,6 +1603,22 @@ function presetResolveContext(options) {
       resolve3(root, entryPoints[path] ?? tailwind?.cssEntryPoint ?? posix2.join(sourcePath, fallback))
     ];
   }));
+  const webStylesheets = [...new Set(Object.values(webCss))];
+  const kitCss = Object.fromEntries((tailwind === false ? [] : uiRoots.filter((path) => !webUiRoots.includes(path))).map((path) => {
+    const owners = packages.flatMap((packageRoot) => {
+      if (path !== packageRoot && !path.startsWith(packageRoot + "/"))
+        return [];
+      const child = path.slice(packageRoot.length + 1).split("/")[0];
+      return isPackage(packageRoot) || !child ? [packageRoot] : [posix2.join(packageRoot, child), packageRoot];
+    });
+    const entry = owners.map((owner) => entryPoints[owner]).find(Boolean);
+    if (entry)
+      return [path, resolve3(root, entry)];
+    if (webStylesheets.length === 1)
+      return [path, webStylesheets[0]];
+    throw new Error(`The UI kit ${path} needs a Tailwind stylesheet: set tailwind.cssEntryPointsByRoot for ${owners[0] ?? path}.`);
+  }));
+  const css = { ...webCss, ...kitCss };
   return {
     options,
     root,
@@ -1628,6 +1643,7 @@ function presetResolveContext(options) {
     utilities,
     types,
     uiRoots,
+    webUiRoots,
     ui,
     generated,
     testFiles,

package/dist/rules/module-policy/index.js

@@ -2195,6 +2195,46 @@ var nextRuntime = defineRule11({
   }
 });
 
+// src/rules/module-policy/no-unknown.ts
+import { defineRule as defineRule12 } from "@oxlint/plugins";
+var noUnknown = defineRule12({
+  meta: { type: "problem", schema: [], messages: { forbidden: "Use an owned domain type rather than unknown." } },
+  createOnce(context) {
+    function catchName(node) {
+      const key = "key" in node && !(("computed" in node) && node.computed) ? node.key : undefined;
+      return key?.type === "Identifier" && key.name === "catch";
+    }
+    function allowed(node) {
+      const annotation = node.parent;
+      const parameter = annotation?.type === "TSTypeAnnotation" ? annotation.parent : undefined;
+      if (parameter?.type !== "Identifier")
+        return false;
+      const owner = parameter.parent;
+      if (!owner || !("params" in owner) || !owner.params.some((entry) => entry === parameter))
+        return false;
+      const predicate = "returnType" in owner ? owner.returnType?.typeAnnotation : undefined;
+      if (predicate?.type === "TSTypePredicate" && predicate.parameterName.type === "Identifier")
+        return predicate.parameterName.name === parameter.name;
+      if (owner.params[0] !== parameter)
+        return false;
+      const holder = owner.parent;
+      if (!holder)
+        return false;
+      if (catchName(owner) || catchName(holder))
+        return true;
+      if (holder.type === "TSTypeAnnotation" && holder.parent && catchName(holder.parent))
+        return true;
+      return holder.type === "CallExpression" && holder.arguments.some((entry) => entry === owner) && holder.callee.type === "MemberExpression" && !holder.callee.computed && holder.callee.property.type === "Identifier" && holder.callee.property.name === "catch";
+    }
+    return {
+      TSUnknownKeyword(node) {
+        if (!allowed(node))
+          context.report({ node, messageId: "forbidden" });
+      }
+    };
+  }
+});
+
 // src/rules/module-policy/index.ts
 var module_policy_default = eslintCompatPlugin({
   meta: { name: "modules" },
@@ -2209,7 +2249,7 @@ var module_policy_default = eslintCompatPlugin({
     "import-boundaries": importBoundaries,
     "tanstack-runtime": tanstackRuntime,
     "local-type-alias": syntaxRule("TSTypeAliasDeclaration", "Local component/hook contracts use interfaces named for their owner. Derived or reusable aliases belong in domain types; do not substitute an empty interface."),
-    "no-unknown": syntaxRule("TSUnknownKeyword", "Use an owned domain type rather than unknown."),
+    "no-unknown": noUnknown,
     memoization,
     "next-runtime": nextRuntime,
     "pascal-interface": syntaxRule("TSInterfaceDeclaration:not([id.name=/^[A-Z][a-zA-Z0-9]*$/])", "Use PascalCase for interfaces."),

package/dist/rules/module-policy/no-unknown.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Rejects the `unknown` type except on the narrowed parameter of a type guard or the error parameter of a catch callback.
+ *
+ * Example: `type Value = unknown` fails; `function isUser(value: unknown): value is User` passes.
+ */
+export declare const noUnknown: import("@oxlint/plugins").Rule;

package/dist/types/preset.types.d.ts

@@ -175,6 +175,8 @@ export interface PresetContext {
     types: string[];
     /** UI kit folders resolved from `shadcn.ui`. */
     uiRoots: string[];
+    /** UI kit folders inside a web source. */
+    webUiRoots: string[];
     ui: string[];
     generated: string[];
     testFiles: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oxlint-plugin-arch",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Configurable architecture rules for Oxlint JavaScript plugins.",
   "type": "module",
   "main": "./dist/index.js",