Tested just now:

• package.json: main file is absent (lib/index was moved to lib/legacy/index);
• not sure, but looks like there are different type objects (node instanceof require('jsdoctypeparser/lib/legacy').Builder.TypeUnion, etc...).

What remained for compatibility check for tj/dox.

I tried the following code based on tj/dox example.
And looks good to me.

/**
 * Escape the given `html`.
 *
 * @example
 *     utils.escape('<script></script>')
 *     // => '&lt;script&gt;&lt;/script&gt;'
 *
 * @param {string[][]} html string to be escaped
 * @return {{String}} escaped html
 * @api public
 */

exports.escape = function(html){
  return String(html)
    .replace(/&(?!\w+;)/g, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;');
};

@zxqfox Ready to be v1.2.0.
Finally, would you re-test it please?

@Kuniwak trying... ;-)

@Kuniwak It works! Sorry for delay 🌴

@Kuniwak Hm. I've found one trouble. What about multiline declarations?

/**
 * @returns {{rules: function(Object),
 *   configure: function(Object),
 *   cases: function(Array.<TestCase{it: string, code: Function, ?rules: Object, ?errors: *, ?skip: boolean}>),
 *   check: function(string)}}
 */

This one is parsed without syntax errors in current version:

{rules: function(Object), configure: function(Object), cases: function(Array.<TestCase{it: string, code: Function, ?rules: Object, ?errors: *, ?skip: boolean}>), check: function(string)}

False error. All is fine. There is an error in syntax. 👍 NICE!!!

Here are changes: https://github.com/jscs-dev/jscs-jsdoc/pull/105/files

Thanks, @zxqfox !