JSDoc param tag's default value parsing should support non-TS expressions

Suggestion

probably related to #44930 but a different use case. default values on @param: https://jsdoc.app/tags-param.html

🔍 Search Terms

jsdoc param default value

⭐ Suggestion

Please allow for default value params parsing

/**
 * @param {string} [somebody=John Doe] - Somebody's name.
 */
export function sayHello(somebody) {
}

currently parses to tags:

[
  {
    name: "param",
    text: [
      {
        text: "somebody",
        kind: "parameterName"
      },
      {
        text: " ",
        kind: "space"
      },
      {
        text: "Doe] - Somebody's name.",
        kind: "text"
      }
    ]
  }
]

possibly add a new node

{
    text: "John Doe",
    kind: "defaultValue"
  },

and clean up the description from

{
  text: "Doe] - Somebody's name.",
  kind: "text"
}

to

{
  text: "- Somebody's name.",
  kind: "text"
}

p.s. it mighy also be worth in general to clean up parameter descriptions text from the leading hyphen

Commencez au point d’entrée de l’analyse de JSDoc @param et comparez l’AST signalé pour [somebody=John Doe] avec le nœud defaultValue demandé. C’est terminé lorsque les expressions par défaut qui ne sont pas de TS sont conservées comme valeurs par défaut, que la description ne contient plus le crochet fermant ni le texte du nom du paramètre, et que la couverture vérifie l’exemple.