feat: strip property when there is a class tag and the context is set (#1414)

* feat: strip property when there is a `class` tag and the context is set; fixes #1376

* Update docs/rules/no-types.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update .README/rules/no-types.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: brettz9

.README/rules/no-types.md

@@ -7,9 +7,12 @@ This rule reports types being used on `@param` or `@returns`.
 The rule is intended to prevent the indication of types on tags where
 the type information would be redundant with TypeScript.
 
+When `contexts` are supplied, will also strip `@property` when on a
+`ClassDeclaration`.
+
 ## Fixer
 
-(TODO)
+Strips any types that are found.
 
 ## Options
 

docs/rules/no-types.md

@@ -15,11 +15,14 @@ This rule reports types being used on `@param` or `@returns`.
 The rule is intended to prevent the indication of types on tags where
 the type information would be redundant with TypeScript.
 
+When `contexts` are supplied, will also strip `@property` when on a
+`ClassDeclaration`.
+
 <a name="user-content-no-types-fixer"></a>
 <a name="no-types-fixer"></a>
 ## Fixer
 
-(TODO)
+Strips any types that are found.
 
 <a name="user-content-no-types-options"></a>
 <a name="no-types-options"></a>
@@ -137,6 +140,15 @@ export interface B {
   methodB(paramB: string): void
 }
 // Message: Types are not permitted on @param.
+
+/**
+ * @class
+ * @property {object} x
+ */
+class Example {
+  x: number;
+}
+// Message: Types are not permitted on @property in the supplied context.
 ````
 
 

src/rules/noTypes.js

@@ -11,6 +11,7 @@ const removeType = ({
 };
 
 export default iterateJsdoc(({
+  node,
   utils,
 }) => {
   if (!utils.isIteratingFunction() && !utils.isVirtualFunction()) {
@@ -30,11 +31,26 @@ export default iterateJsdoc(({
       });
     }
   }
+
+  if (node?.type === 'ClassDeclaration') {
+    const propertyTags = utils.getPresentTags([
+      'prop', 'property',
+    ]);
+    for (const tag of propertyTags) {
+      if (tag.type) {
+        utils.reportJSDoc(`Types are not permitted on @${tag.tag} in the supplied context.`, tag, () => {
+          for (const source of tag.source) {
+            removeType(source);
+          }
+        });
+      }
+    }
+  }
 }, {
   contextDefaults: [
     'ArrowFunctionExpression', 'FunctionDeclaration', 'FunctionExpression', 'TSDeclareFunction',
     // Add this to above defaults
-    'TSMethodSignature',
+    'TSMethodSignature', 'ClassDeclaration',
   ],
   meta: {
     docs: {

test/rules/assertions/noTypes.js

@@ -257,6 +257,35 @@ export default /** @type {import('../index.js').TestCases} */ ({
         }
       `,
     },
+    {
+      code: `
+        /**
+         * @class
+         * @property {object} x
+         */
+        class Example {
+          x: number;
+        }
+      `,
+      errors: [
+        {
+          line: 4,
+          message: 'Types are not permitted on @property in the supplied context.',
+        },
+      ],
+      languageOptions: {
+        parser: typescriptEslintParser,
+      },
+      output: `
+        /**
+         * @class
+         * @property x
+         */
+        class Example {
+          x: number;
+        }
+      `,
+    },
   ],
   valid: [
     {