fix: jsdoc rules for js and ts

Author: RebeccaStevens

src/plugins/jsdoc.ts

@@ -1,30 +1,18 @@
+import { typescriptFiles } from "common/files";
 import type { Linter } from "eslint";
 
 export const settings: Linter.Config = {
   plugins: ["jsdoc"],
 
+  extends: ["plugin:jsdoc/recommended"],
+
   rules: {
-    "jsdoc/check-access": "warn",
-    "jsdoc/check-alignment": "warn",
     // waiting on https://github.com/eslint/eslint/issues/14745
     // "jsdoc/check-examples": "warn",
     "jsdoc/check-indentation": "warn",
     "jsdoc/check-line-alignment": "warn",
-    "jsdoc/check-param-names": "warn",
-    "jsdoc/check-property-names": "warn",
-    "jsdoc/check-tag-names": "warn",
-    "jsdoc/check-types": "warn",
-    "jsdoc/check-values": "warn",
-    "jsdoc/empty-tags": "warn",
-    "jsdoc/implements-on-classes": "warn",
-    "jsdoc/multiline-blocks": "warn",
-    "jsdoc/newline-after-description": "warn",
     "jsdoc/no-bad-blocks": "warn",
     "jsdoc/no-defaults": "warn",
-    "jsdoc/no-multi-asterisks": "warn",
-    // For TypeScript
-    "jsdoc/no-types": "warn",
-    "jsdoc/no-undefined-types": "warn",
     "jsdoc/require-asterisk-prefix": "warn",
     "jsdoc/require-description": "warn",
     // Rule is too strict.
@@ -47,20 +35,26 @@ export const settings: Linter.Config = {
         },
       },
     ],
-    "jsdoc/require-param-description": "warn",
-    "jsdoc/require-param-name": "warn",
-    "jsdoc/require-property-description": "warn",
-    "jsdoc/require-property-name": "warn",
-    "jsdoc/require-returns-check": "warn",
-    "jsdoc/require-returns-description": "warn",
     "jsdoc/require-throws": "warn",
-    "jsdoc/require-yields": "warn",
-    "jsdoc/require-yields-check": "warn",
     "jsdoc/tag-lines": [
       "warn",
       "never",
       { noEndLines: true, tags: { example: { lines: "always" } } },
     ],
-    "jsdoc/valid-types": "warn",
   },
+
+  overrides: [
+    {
+      files: typescriptFiles,
+      rules: {
+        "jsdoc/no-types": "warn",
+        "jsdoc/require-param-type": "off",
+        "jsdoc/require-param": "off",
+        "jsdoc/require-property-type": "off",
+        "jsdoc/require-property": "off",
+        "jsdoc/require-returns-type": "off",
+        "jsdoc/require-returns": "off",
+      },
+    },
+  ],
 };