feat: replace jsdoc with tsdoc

.eslintrc.js

@@ -9,7 +9,6 @@ module.exports = {
         'plugin:@typescript-eslint/eslint-recommended',
         'plugin:prettier/recommended',
         'plugin:sonarjs/recommended',
-        'plugin:jsdoc/recommended',
     ],
     parser: '@typescript-eslint/parser',
     parserOptions: {
@@ -20,9 +19,9 @@ module.exports = {
         '@typescript-eslint',
         'prettier',
         'sonarjs',
-        'jsdoc',
         'prefer-arrow',
         'ban',
+        'eslint-plugin-tsdoc',
     ],
     settings: {
         react: {
@@ -67,10 +66,6 @@ module.exports = {
         eqeqeq: ['error', 'always'],
         'guard-for-in': 'error',
         'id-match': 'error',
-        'jsdoc/check-indentation': 'error',
-        'jsdoc/require-jsdoc': 'off',
-        'jsdoc/no-undefined-types': 'off',
-        'jsdoc/check-tag-names': 'off',
         'max-classes-per-file': ['error', 1],
         'multiline-ternary': ['error', 'never'],
         'no-bitwise': 'error',
@@ -129,6 +124,7 @@ module.exports = {
                 markers: ['/'],
             },
         ],
+        'tsdoc/syntax': 'warn',
     },
     overrides: [
         {
@@ -176,8 +172,6 @@ module.exports = {
                 '@typescript-eslint/dot-notation': 'error',
                 'sonarjs/no-duplicate-string': 'off',
                 'sonarjs/no-identical-functions': 'off',
-                'jsdoc/require-returns': 'off',
-                'jsdoc/require-param': 'off',
                 'no-console': 'off',
                 'no-magic-numbers': 'off',
                 'prefer-arrow/prefer-arrow-functions': 'off',

package.json

@@ -33,14 +33,14 @@
   },
   "dependencies": {
     "@typescript-eslint/parser": "^6.9.0",
+    "eslint-plugin-tsdoc": "^0.2.17",
     "gently-copy": "^3.2.0"
   },
   "devDependencies": {
     "@typescript-eslint/eslint-plugin": "^6.9.0",
     "eslint": "^8.52.0",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-ban": "^1.6.0",
-    "eslint-plugin-jsdoc": "^46.8.2",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "eslint-plugin-prettier": "^5.0.1",
     "eslint-plugin-react": "^7.33.2",
@@ -52,7 +52,6 @@
     "eslint": "^8.52.0",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-ban": "^1.6.0",
-    "eslint-plugin-jsdoc": "^46.8.2",
     "eslint-plugin-prefer-arrow": "^1.2.3",
     "eslint-plugin-prettier": "^5.0.1",
     "eslint-plugin-react": "^7.33.2",

tsdoc.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/tsdoc/v0/tsdoc.schema.json",
+  "tagDefinitions": [
+    {
+      "tagName": "@id",
+      "syntaxKind": "block"
+    },
+    {
+      "tagName": "@note",
+      "syntaxKind": "block",
+      "allowMultiple": true
+    },
+    {
+      "tagName": "@event",
+      "syntaxKind": "block"
+    },
+    {
+      "tagName": "@emits",
+      "syntaxKind": "block"
+    }
+  ]
+}