fix: update comment-parser to surface restoration of support for eq…

…ual signs in defaults and multi-line types; fixes #669; fixes #673

README.md

@@ -11381,6 +11381,13 @@ function quux (foo) {
  * @callback
  * @param
  */
+
+/**
+ * @param {Function} [processor=data => data] A function to run
+ */
+function processData(processor) {
+  return processor(data)
+}
 ````
 
 
@@ -13318,6 +13325,15 @@ The following patterns are not considered problems:
  * @class
  * @property foo Foo.
  */
+
+/**
+ * Typedef with multi-line property type.
+ *
+ * @typedef {object} MyType
+ * @property {function(
+ *   number
+ * )} numberEater Method which takes a number.
+ */
 ````
 
 

package.json

@@ -5,7 +5,7 @@
     "url": "http://gajus.com"
   },
   "dependencies": {
-    "comment-parser": "1.0.1",
+    "comment-parser": "1.1.0",
     "debug": "^4.3.1",
     "jsdoctypeparser": "^9.0.0",
     "lodash": "^4.17.20",

src/iterateJsdoc.js

@@ -1,13 +1,14 @@
 import {
   parse as commentParser, stringify as commentStringify,
 } from 'comment-parser';
-import getSpacer from 'comment-parser/lib/parser/spacer';
 import {
-  tagTokenizer,
-  typeTokenizer,
-  nameTokenizer,
-  descriptionTokenizer,
-} from 'comment-parser/lib/parser/spec-parser';
+  // eslint-disable-next-line import/no-named-default
+  default as descriptionTokenizer,
+  getJoiner,
+} from 'comment-parser/lib/parser/tokenizers/description';
+import nameTokenizer from 'comment-parser/lib/parser/tokenizers/name';
+import tagTokenizer from 'comment-parser/lib/parser/tokenizers/tag';
+import typeTokenizer from 'comment-parser/lib/parser/tokenizers/type';
 import {
   rewireSpecs,
   seedBlock,
@@ -83,7 +84,7 @@ const getTokenizers = () => {
 
     // Description
     (spec) => {
-      return descriptionTokenizer(getSpacer('preserve'))(spec);
+      return descriptionTokenizer(getJoiner('preserve'))(spec);
     },
   ];
 };

test/rules/assertions/requireParamName.js

@@ -161,5 +161,15 @@ export default {
            */
       `,
     },
+    {
+      code: `
+      /**
+       * @param {Function} [processor=data => data] A function to run
+       */
+      function processData(processor) {
+        return processor(data)
+      }
+      `,
+    },
   ],
 };

test/rules/assertions/requirePropertyDescription.js

@@ -89,5 +89,17 @@ export default {
            */
       `,
     },
+    {
+      code: `
+      /**
+       * Typedef with multi-line property type.
+       *
+       * @typedef {object} MyType
+       * @property {function(
+       *   number
+       * )} numberEater Method which takes a number.
+       */
+      `,
+    },
   ],
 };