docs: Update eslint-plugin-jsdoc

Author: manthey

eslint.config.js

@@ -71,7 +71,7 @@ module.exports = [
   }, {
     files: ['src/**/*.js'],
     plugins: {
-      jsdoc,
+      jsdoc, 'jsdoc-overrides': require('./jsdoc/linting')
     },
     rules: {
       'jsdoc/check-types': ['warn', {
@@ -88,9 +88,13 @@ module.exports = [
       'jsdoc/check-param-names': 'off',
       'jsdoc/check-tag-names': 'off',
       'jsdoc/no-undefined-types': 'off',
+      'jsdoc/reject-any-type': 'off',
+      'jsdoc/reject-function-type': 'off',
       'jsdoc/require-param-description': 'off',
       'jsdoc/require-returns-description': 'off',
       'jsdoc/tag-lines': 'off',
+      'jsdoc/valid-types': 'off',
+      'jsdoc-overrides/valid-types': 'warn',
       'no-console': 'error',
     }
   }, {
@@ -104,6 +108,7 @@ module.exports = [
       'jsdoc/no-defaults': 'off',
       'jsdoc/no-multi-asterisks': 'off',
       'jsdoc/no-undefined-types': 'off',
+      'jsdoc/reject-function-type': 'off',
       'jsdoc/require-jsdoc': 'off',
       'jsdoc/require-param': 'off',
       'jsdoc/require-param-description': 'off',

jsdoc/linting.js

@@ -0,0 +1,28 @@
+module.exports.rules = {
+  'valid-types': {
+    meta: {
+      docs: {
+        description: 'Override jsdoc/valid-types to ignore typedef names',
+        category: 'Best Practices',
+        recommended: false,
+      },
+      type: 'problem',
+      fixable: null,
+      schema: [], // we just delegate to original rule
+    },
+    create(context) {
+      // Load the original rule
+      const originalRule = require('eslint-plugin-jsdoc').rules['valid-types'];
+      const original = originalRule.create(context);
+      return {
+        JSDoc: (node) => {
+          const tags = (node.tags || []).filter(tag => {
+            if (tag.tag !== 'typedef') return true;
+            return (tag.name || '').startsWith('geo.');
+          });
+          if (tags.length) original.JSDoc({ ...node, tags });
+        },
+      };
+    },
+  },
+};